> ## 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.

# API Overview

> Introduction to the Agile Tools REST API

# API Overview

The Agile Tools API provides programmatic access to OKRs, Value Units, Teams, and work management data.

## Base URL

```
https://api.agile-tools.io/v1
```

For self-hosted Enterprise installations, replace with your instance URL.

## Authentication

All API requests require authentication via **API tokens** or **OAuth 2.0**.

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.agile-tools.io/v1/okrs
```

See [Authentication](https://docs.agile-tools.io/en/developer/api/authentication.md) for detailed setup instructions.

## Core Resources

| Resource | Description | Endpoint |
| - | - | - |
| **OKRs** | Objectives and Key Results | `/okrs` |
| **Key Results** | Individual Key Results | `/key-results` |
| **Value Units** | Products, projects, initiatives | `/value-units` |
| **Teams** | Cross-functional teams | `/teams` |
| **Org Units** | Organizational structure | `/org-units` |
| **Users** | User accounts | `/users` |
| **Cycles** | OKR time periods | `/cycles` |

## Response Format

All responses are JSON:

```json theme={null}
{
  "data": {
    "id": "okr_abc123",
    "type": "okr",
    "attributes": {
      "title": "Become market leader in customer satisfaction",
      "status": "active",
      "progress": 0.65
    }
  }
}
```

## Rate Limits

| Plan | Requests per minute |
| - | - |
| Starter | 60 |
| Professional | 300 |
| Enterprise | Custom |

Rate limit headers are included in every response:

```
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1640000000
```

## Quick Links

> **[Quick Start](https://docs.agile-tools.io/en/developer/api/quick-start.md)**
>
> Make your first API call

> **[Authentication](https://docs.agile-tools.io/en/developer/api/authentication.md)**
>
> Set up API tokens and OAuth

> **[Webhooks](https://docs.agile-tools.io/en/developer/api/webhooks.md)**
>
> Receive real-time updates

> **[OpenAPI Spec](https://docs.agile-tools.io/en/developer/api/openapi.md)**
>
> Download the full API specification

## SDKs & Tools

Official SDKs are coming soon. In the meantime, use our OpenAPI specification with code generators:

* [OpenAPI Generator](https://openapi-generator.tech/)
* [Swagger Codegen](https://swagger.io/tools/swagger-codegen/)

See [CLI](https://docs.agile-tools.io/en/developer/cli/overview.md) for command-line access.


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