# Errors

> Errors return a JSON body of the form {"error":{"code","message","request_id"}}. The codes are invalid_field, unauthorized, forbidden, not_found, conflict and rate_limited.

Source: https://stacklyhq.xyz/docs/api-reference/errors

## Getting started

- [Quickstart](https://stacklyhq.xyz/docs/getting-started/quickstart)
- [Create a workspace](https://stacklyhq.xyz/docs/getting-started/create-a-workspace)
- [Invite your team](https://stacklyhq.xyz/docs/getting-started/invite-your-team)
- [Import from CSV](https://stacklyhq.xyz/docs/getting-started/import-from-csv)

## Concepts

- [Workspaces and projects](https://stacklyhq.xyz/docs/concepts/workspaces-and-projects)
- [Tasks and subtasks](https://stacklyhq.xyz/docs/concepts/tasks-and-subtasks)
- [Statuses and workflows](https://stacklyhq.xyz/docs/concepts/statuses-and-workflows)
- [Labels and priorities](https://stacklyhq.xyz/docs/concepts/labels-and-priorities)
- [Roles and permissions](https://stacklyhq.xyz/docs/concepts/roles-and-permissions)

## API reference

- [API overview](https://stacklyhq.xyz/docs/api-reference/overview)
- [Authentication](https://stacklyhq.xyz/docs/api-reference/authentication)
- [Pagination](https://stacklyhq.xyz/docs/api-reference/pagination)
- **Errors**
- [Tasks API](https://stacklyhq.xyz/docs/api-reference/tasks)
- [Projects API](https://stacklyhq.xyz/docs/api-reference/projects)
- [Comments API](https://stacklyhq.xyz/docs/api-reference/comments)
- [Users API](https://stacklyhq.xyz/docs/api-reference/users)
- [Stackly API reference (complete)](https://stacklyhq.xyz/docs/api-reference/full)

## Webhooks

- [Webhooks overview](https://stacklyhq.xyz/docs/webhooks/overview)
- [Webhook events](https://stacklyhq.xyz/docs/webhooks/events)
- [Webhook signatures](https://stacklyhq.xyz/docs/webhooks/signatures)
- [Webhook retries](https://stacklyhq.xyz/docs/webhooks/retries)

## SDKs

- [TypeScript SDK](https://stacklyhq.xyz/docs/sdks/typescript)
- [Python SDK](https://stacklyhq.xyz/docs/sdks/python)
- [Go SDK](https://stacklyhq.xyz/docs/sdks/go)

## Security

- [Security overview](https://stacklyhq.xyz/docs/security/overview)
- [Single sign-on](https://stacklyhq.xyz/docs/security/sso)
- [Data retention](https://stacklyhq.xyz/docs/security/data-retention)

## Limits

- [Plan limits](https://stacklyhq.xyz/docs/limits/plan-limits)
- [Rate limits](https://stacklyhq.xyz/docs/limits/rate-limits)

1. [Docs](https://stacklyhq.xyz/docs)
2. API reference
3. Errors

# Errors

Errors return a JSON body of the form {"error":{"code","message","request_id"}}. The codes are invalid_field, unauthorized, forbidden, not_found, conflict and rate_limited.

## 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. (Errors, note 2.)
- Send Content-Type: application/json on requests that have a body. (Errors, note 2.)
- Each response includes a request_id; quote it when you contact support. (Errors, note 2.)
- Timestamps are ISO 8601 in UTC, and identifiers are opaque strings. (Errors, note 2.)
- Write requests accept an Idempotency-Key header, so a retried request does not create a duplicate. (Errors, note 2.)
- Rate limits are per workspace per minute, and the response headers show how many requests remain. (Errors, note 2.)
- The SDKs for TypeScript, Python and Go wrap these calls and handle pagination for you. (Errors, note 2.)
- Fields not listed on this page are ignored on write and may be added to responses later. (Errors, note 2.)

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

## See also

- [API overview](https://stacklyhq.xyz/docs/api-reference/overview)
- [Webhook retries](https://stacklyhq.xyz/docs/webhooks/retries)

Previous: [Pagination](https://stacklyhq.xyz/docs/api-reference/pagination) | Next: [Tasks API](https://stacklyhq.xyz/docs/api-reference/tasks)