Assistant Management

Manage assistants.

Deprecated

List assistants for a specific user. Deprecated, use /v1/agents instead.

get

Deprecated: Use /v1/agents instead. Retrieve list of assistants for a specific user.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · int64 · min: 1 · max: 200Optional

The number of items to return.

Default: 100

offsetinteger · int64Optional

The number of items to skip.

sort_by.fieldstring · enumOptional

Field to sort by, must be used together with sort_by.order.

Possible values:

sort_by.orderstring · enumOptional

Sort order, must be used together with sort_by.field.

Possible values:

include_sharedbooleanOptional

Whether to include assistants shared with the user.

Default: false

Responses

200

A list of assistants.

application/json

totalinteger · int64OptionalExample: 1

404

Assistant not found.

get/v1/assistants

GET /v1/assistants HTTP/1.1
Host: api.nexos.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "11f71a8d-03e9-4c4c-a8f0-aa2984f1849a",
      "name": "text",
      "description": "text",
      "instructions": "text",
      "model": "chat-gpt-o4",
      "created_at": "2024-11-19T10:00:00Z"
    }
  ],
  "total": 1
}