The Agiler REST API is now stable. Version 1, served at https://api.agiler.io/v1, is covered by a backwards-compatibility commitment: existing integrations will continue to work, and we will not introduce breaking changes within v1.
This release also adds scope-based permissions to API keys. A key can be granted only the scopes it requires and restricted to specific projects or workspaces, rather than holding full account access. Scopes are granular (for example, projects:read, projects.files:write, and billing:read), and broader scopes imply narrower ones, so projects:write grants every scope within a project without enumerating each.
API keys are created and scoped from your dashboard. Authenticate each request with the key as a bearer token:
curl https://api.agiler.io/v1/projects \
-H "Authorization: Bearer $AGILER_TOKEN"
Full documentation:
- API reference: /docs/api/
- OpenAPI spec: /openapi.json, for use with tools such as Postman, Insomnia, and openapi-generator.