Developer FAQ

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

How do I get an API token?

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 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:

{
  "data": [...],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 150,
    "total_pages": 6
  }
}

Use ?page=2&per_page=50 query parameters. See Pagination.

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.

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 - GitLab Setup - Bitbucket Setup 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 for code generation tips.

API

API Reference

API Guides

CLI

Integration Automation

Support

Developer FAQ

Developer FAQ

Still have questions?

​Developer FAQ

​Still have questions?

Developer FAQ

Still have questions?