API Reference

The AgileTune REST API lets you programmatically manage organizations, projects, tasks, and members. All responses are JSON.

Base URL

https://api.agiletune.com/v1

Authentication

AgileTune supports two authentication methods:

API Keys

Generate an API key from Organization Settings → API Keys. Include it in the Authorization header:

Authorization: Bearer at_live_abc123...

API keys inherit the permissions of the user who created them. You can scope keys to specific projects and set an expiration date.

OAuth 2.0

For third-party integrations, use the OAuth 2.0 authorization code flow. Register your application in Organization Settings → OAuth Apps to obtain a client ID and secret. See the full OAuth guide in the OpenAPI docs.

Rate Limits

API requests are rate-limited per API key:

  • Free plan — 60 requests per minute
  • Pro plan — 300 requests per minute
  • Business / Enterprise — 1,000 requests per minute

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

Common Endpoints

MethodEndpointDescription
GET/orgsList your organizations
GET/orgs/:orgId/projectsList projects in an organization
POST/orgs/:orgId/projectsCreate a new project
GET/projects/:projectId/tasksList tasks in a project
POST/projects/:projectId/tasksCreate a task
PATCH/tasks/:taskIdUpdate a task
DELETE/tasks/:taskIdDelete a task
GET/orgs/:orgId/membersList organization members

Error Format

Errors return a consistent JSON structure:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Title is required",
    "details": [
      { "field": "title", "message": "must not be empty" }
    ]
  }
}

Full OpenAPI Documentation

For the complete API reference with request/response schemas, interactive examples, and code generation, visit the OpenAPI documentation.

← WebhooksEnvironments →