> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agile-tools.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer FAQ

> Frequently asked questions for developers integrating with Agile Tools

# Developer FAQ

Common questions about the Agile Tools API, CLI, and integrations.

> **How do I get an API token?**
>
> 1. Log in to Agile Tools 2. Go to **Profile** → **API Tokens** 3. Click
>    **Generate Token** and give it a descriptive name 4. Copy the token
>    immediately — it won't be shown again See
>    [Authentication](https://docs.agile-tools.io/en/developer/api/authentication.md) for OAuth setup.

> **What's the rate limit for API calls?**
>
> Rate limits depend on your plan: - **Starter:** 60 requests/minute -
> **Professional:** 300 requests/minute - **Enterprise:** Custom limits Check
> `X-RateLimit-Remaining` header in responses.

> **Is there a sandbox/test environment?**
>
> Yes. Use `https://sandbox.agile-tools.io` for testing. Sandbox data resets
> weekly. Contact support for sandbox access credentials.

> **How do I handle pagination?**
>
> List endpoints return paginated responses:
>
> ```json theme={null}
> {
>   "data": [...],
>   "meta": {
>     "page": 1,
>     "per_page": 25,
>     "total": 150,
>     "total_pages": 6
>   }
> }
> ```
>
> Use `?page=2&per_page=50` query parameters. See [Pagination](https://docs.agile-tools.io/en/developer/api/pagination.md).

> **Can I use webhooks to sync with other tools?**
>
> Yes. Configure outgoing webhooks in **Settings** → **Integrations** →
> **Webhooks**. Events include: - `okr.created`, `okr.updated`, `okr.completed`
>
> * `key_result.progress_updated` - `value_item.status_changed` See [Webhooks
>   Guide](https://docs.agile-tools.io/en/developer/api/webhooks.md).

> **I need to connect a Git provider but I'm not an Admin**
>
> Git provider connections require Administrator access for initial OAuth setup.
> Ask your Admin to complete the connection first: - [GitHub
> Setup](https://docs.agile-tools.io/en/admin/integrations/github.md) - [GitLab
> Setup](https://docs.agile-tools.io/en/admin/integrations/gitlab.md) - [Bitbucket
> Setup](https://docs.agile-tools.io/en/admin/integrations/bitbucket.md) Once connected, you can use the API
> to automate sync workflows.

> **Is there an OpenAPI/Swagger specification?**
>
> Yes. Download from: - JSON: `https://api.agile-tools.io/v1/openapi.json` -
> YAML: `https://api.agile-tools.io/v1/openapi.yaml` See [Using
> OpenAPI](https://docs.agile-tools.io/en/developer/api/openapi.md) for code generation tips.

## Still have questions?

* [Contact Support](https://docs.agile-tools.io/en/docs/contact-support.md)
* [Global FAQ](https://docs.agile-tools.io/en/docs/faq.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.