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

# API reference

> Every AiGenda API request with parameters, responses, and examples.

Each reference page describes one request: parameters, response fields, and examples in cURL, Python, and JavaScript. The **Try it** button sends the request right from the page.

## Basics

| | |
| - | - |
| Base URL | `https://api.aigenda.tech` |
| Body format | `application/json`, UTF-8 |
| Authorization | `Authorization: Bearer <access>`, except for [getting](/en/api-reference/auth/token) and [refreshing](/en/api-reference/auth/refresh) a token |
| IDs | Integers: `space_id`, `audio_id` |
| Dates | ISO 8601 with a time zone offset: `2026-10-17T12:30:00.481233+03:00`. A subscription's `end_date` comes as a date: `2026-11-17` |
| Duration and plan minutes | Seconds |
| Lists | `limit` and `offset`, response `{count, next, previous, results}` |

## How to try a request

1. Get a token on the [Get a token](/en/api-reference/auth/token) page: click **Try it** and enter your email and password.
2. Copy `access` from the response.
3. On the page of the request you need, paste the token into the authorization field and fill in the parameters.

<Warning>
  Requests from the playground run against the production API with your account. Starting processing charges minutes, and the recordings you create appear in your space.
</Warning>

## Request map

| Task | Requests |
| - | - |
| Sign in | [Get a token](/en/api-reference/auth/token), [Refresh a token](/en/api-reference/auth/refresh) |
| Pick a space | [List spaces](/en/api-reference/spaces/list), [Get a space](/en/api-reference/spaces/get), [Rights](/en/api-reference/spaces/rights) |
| Upload a file | [Create a recording](/en/api-reference/audio/create) → `PUT` to storage → [Complete upload](/en/api-reference/audio/complete-upload) → [Upload status](/en/api-reference/audio/info) |
| Upload by URL | [By URL](/en/api-reference/audio/by-url), [From YouTube](/en/api-reference/audio/by-youtube) |
| Record a meeting | [Send a bot](/en/api-reference/meetings/create) |
| Process | [Start processing](/en/api-reference/processing/classify) or [Transcript only](/en/api-reference/processing/classify-transcription) → [Result](/en/api-reference/processing/result) |
| Clean up | [List recordings](/en/api-reference/audio/list), [Delete](/en/api-reference/audio/delete), [Trash](/en/api-reference/audio/trash) |


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