# Python SDK

> Install the package stackly from PyPI. It needs Python 3.10 or newer.

Source: https://stacklyhq.xyz/docs/sdks/python

## 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](https://stacklyhq.xyz/docs/api-reference/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**
- [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. SDKs
3. Python SDK

# Python SDK

Install the package stackly from PyPI. It needs Python 3.10 or newer.

## Details

- The SDKs are thin wrappers over the REST API and follow its names closely.
- Each SDK reads the token from the STACKLY_TOKEN environment variable unless you pass one in.
- Pagination helpers return an iterator that follows next_cursor until the list ends.
- Errors are raised as typed exceptions that carry the error code and the request_id.
- The SDKs retry requests that fail with a rate_limited error after the Retry-After delay.
- Releases of the SDKs are listed in the changelog under the API channel.
- Every Stackly plan can use the SDKs, because every plan includes the API.
- Report problems with an SDK to support@stackly.test with the version number.
- The SDKs are thin wrappers over the REST API and follow its names closely. (Python SDK, note 2.)
- Each SDK reads the token from the STACKLY_TOKEN environment variable unless you pass one in. (Python SDK, note 2.)
- Pagination helpers return an iterator that follows next_cursor until the list ends. (Python SDK, note 2.)
- Errors are raised as typed exceptions that carry the error code and the request_id. (Python SDK, note 2.)
- The SDKs retry requests that fail with a rate_limited error after the Retry-After delay. (Python SDK, note 2.)
- Releases of the SDKs are listed in the changelog under the API channel. (Python SDK, note 2.)
- Every Stackly plan can use the SDKs, because every plan includes the API. (Python SDK, note 2.)

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

## See also

- [TypeScript SDK](https://stacklyhq.xyz/docs/sdks/typescript)
- [Data retention](https://stacklyhq.xyz/docs/security/data-retention)

Previous: [TypeScript SDK](https://stacklyhq.xyz/docs/sdks/typescript) | Next: [Go SDK](https://stacklyhq.xyz/docs/sdks/go)