Projects - AUI

A project groups agents within your organization — typically one project per product, environment, or team. All management endpoints accept a Bearer token from a login session or your organization API key (see Authentication).

Create a project

cURL

curl -X POST "https://api-v3.aui.io/apollo-api/management/v1/projects" \
  -H "Content-Type: application/json" \
  -H "x-organization-api-key: <org_api_key>" \
  -d '{ "name": "Support agents" }'

POST `/management/v1/projects`

name

string

required

Project name — 2 to 100 characters, and not only whitespace.

{
  "id": "5f2b8c1a9d4e3f0012ab34cd",
  "name": "Support agents",
  "created_at": "2026-07-13T14:02:11Z",
  "updated_at": "2026-07-13T14:02:11Z"
}

List projects

cURL

curl "https://api-v3.aui.io/apollo-api/management/v1/projects?page[size]=20" \
  -H "x-organization-api-key: <org_api_key>"

GET `/management/v1/projects`

Returns your organization’s projects as a paginated list (see Pagination below).

Get a project

GET `/management/v1/projects/{projectId}`

Returns one project.

Delete a project

DELETE `/management/v1/projects/{projectId}`

Deletes a project; it disappears from listings immediately. Returns 204.

Project usage

GET `/management/v1/projects/{projectId}/usage`

Usage metrics aggregated across every agent in the project — see Usage.

Pagination

Every list endpoint on the management surface shares one cursor-based envelope:

Query parameters

page[size]

integer

Items per page.

page[after]

string

Cursor from a previous response’s meta.after_cursor — fetches the next page. Mutually exclusive with page[before].

page[before]

string

Cursor from meta.before_cursor — fetches the previous page.

sort_by

string

Field to sort by.

sort_order

string

asc or desc.

Response envelope

{
  "results": [ ... ],
  "meta": {
    "has_more": true,
    "after_cursor": "b2Zmc2V0PTIw",
    "before_cursor": null
  },
  "links": {
    "next": "/management/v1/projects?page[size]=20&page[after]=b2Zmc2V0PTIw",
    "prev": null
  }
}

Always echo back the cursor you were given (meta.after_cursor / meta.before_cursor or the ready-made links) rather than constructing your own.

​Create a project

​POST /management/v1/projects

​List projects

​GET /management/v1/projects

​Get a project

​GET /management/v1/projects/{projectId}

​Delete a project

​DELETE /management/v1/projects/{projectId}

​Project usage

​GET /management/v1/projects/{projectId}/usage

​Pagination

​Query parameters

​Response envelope

Create a project

POST `/management/v1/projects`

List projects

GET `/management/v1/projects`

Get a project

GET `/management/v1/projects/{projectId}`

Delete a project

DELETE `/management/v1/projects/{projectId}`

Project usage

GET `/management/v1/projects/{projectId}/usage`

Pagination

Query parameters

Response envelope