Spaces and minutes

A space groups recordings, members, and a plan. Every account has a personal space. Team spaces appear when colleagues invite you. Almost every recording request includes space_id.

Find your space_id

curl "https://api.aigenda.tech/api/spaces/?limit=50&offset=0" \
  -H "Authorization: Bearer <access>"

Response 200 (main fields)

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "is_main_space": true,
      "space": {
        "id": 1024,
        "name": "Personal space",
        "description": "Main space",
        "subscribe": {
          "offer": { "name": "PRO", "audio_limit": 72000 },
          "usage_count": 5400,
          "available_usage_count": 66600,
          "is_active": true,
          "end_date": "2026-11-17"
        }
      }
    },
    {
      "is_main_space": false,
      "space": { "id": 2048, "name": "Sales", "description": "Client call recordings" }
    }
  ]
}

Your personal space is marked with is_main_space: true. Its space.id is your space_id.

Minutes

The plan and balance are in space.subscribe. All values are in seconds.

Field	Meaning
`offer.name`	Plan name
`offer.audio_limit`	How many seconds the plan gives per period
`usage_count`	How many are already used
`available_usage_count`	How many are left
`end_date`	When the period ends

A space without a plan has subscribe set to null. GET /api/spaces/{space_id}/ returns the current balance of a specific space. When minutes are charged. When you start processing, for exactly the recording’s duration in whole seconds (a 71.8 s recording is charged 71 s). Uploading without processing costs no minutes. If processing fails, the minutes come back on their own within a couple of minutes.

Before starting processing, check that the balance is at least the recording’s duration. Otherwise classify responds with 403 and "code": 1, see Starting processing. A meeting bot needs at least 5 minutes left.

Rights

In a team space you may not have the right to upload recordings. Check it in advance:

curl "https://api.aigenda.tech/api/spaces/1024/my_rights/" \
  -H "Authorization: Bearer <access>"

You can upload recordings if the response contains write_access: true. Full list of fields: Space rights.

Pagination

Lists (spaces, recordings, trash) are returned in pages. Control them with the limit and offset parameters. The next and previous links in the response use the http:// scheme, so build the next page URL yourself: offset = offset + limit while offset < count.

Get started

Upload a recording

Processing and results

Reference

Spaces and minutes

Find your space_id

Minutes

Rights

​Find your space_id

​Minutes

​Rights

​Pagination

Find your space_id

Minutes

Rights

Pagination