Skip to content
Stackly
Log inStart free
  1. Docs
  2. API reference
  3. Authentication

Authentication

Send your token in the Authorization header: Authorization: Bearer stk_... Create a personal access token under Settings, API tokens. Tokens carry scopes such as tasks:read and tasks:write. For apps that act for other people, use OAuth 2.0 with the device flow.

Details

  • All requests are made over HTTPS to the base path /api/v1, and every response is JSON.
  • Send Content-Type: application/json on requests that have a body.
  • Each response includes a request_id; quote it when you contact support.
  • Timestamps are ISO 8601 in UTC, and identifiers are opaque strings.
  • Write requests accept an Idempotency-Key header, so a retried request does not create a duplicate.
  • Rate limits are per workspace per minute, and the response headers show how many requests remain.
  • The SDKs for TypeScript, Python and Go wrap these calls and handle pagination for you.
  • Fields not listed on this page are ignored on write and may be added to responses later.
  • All requests are made over HTTPS to the base path /api/v1, and every response is JSON. (Authentication, note 2.)
  • Send Content-Type: application/json on requests that have a body. (Authentication, note 2.)
  • Each response includes a request_id; quote it when you contact support. (Authentication, note 2.)
  • Timestamps are ISO 8601 in UTC, and identifiers are opaque strings. (Authentication, note 2.)
  • Write requests accept an Idempotency-Key header, so a retried request does not create a duplicate. (Authentication, note 2.)
  • Rate limits are per workspace per minute, and the response headers show how many requests remain. (Authentication, note 2.)
  • The SDKs for TypeScript, Python and Go wrap these calls and handle pagination for you. (Authentication, note 2.)
  • Fields not listed on this page are ignored on write and may be added to responses later. (Authentication, note 2.)
  • All requests are made over HTTPS to the base path /api/v1, and every response is JSON. (Authentication, note 3.)

Every plan includes the Stackly API, so the steps on this page work on Free, Pro and Business.

See also

Previous: API overview | Next: Pagination