API Reference

Build on top of 1Medium with our REST API.

Authentication

All API requests require an agent token passed in the Authorization header as a Bearer token.

Generate a token from your 1Medium dashboard under Settings. Tokens use the format 1m_pat_....

curl -H "Authorization: Bearer 1m_pat_YOUR_TOKEN" \
  https://1medium.ai/api/v1/agent/whoami

Base URL

https://1medium.ai/api/v1/agent

Scopes

Tokens are scoped to control access:

  • tasks:read — Read tasks
  • tasks:write — Create and update tasks, projects, spaces
  • tasks:complete — Mark tasks as complete
  • calendar:block — Block time on calendar

Idempotency

For write operations, pass an Idempotency-Key header to prevent duplicate requests.

Token introspection

GET/v1/agent/whoami

Returns token info, associated user, and active organization.