List assistants

GET 
/ai/assistants

Retrieve a list of all AI Assistants configured by the user.

200: Successful Response

application/json

• Schema
• Example (from schema)

Schema

data

object[]

required

Array [

id Id (string)required

name Name (string)required

created_at date-timerequired

description Description (string)

model Model (string)required

instructions Instructions (string)required

tools

object[]

Array [

oneOf

• Function
• Retrieval

type stringrequired

Possible values: [function]

function

object

required

name stringrequired

description string

parameters object

type stringrequired

Possible values: [retrieval]

retrieval

object

required

bucket_ids string[]required

max_num_results integer

The maximum number of results to retrieve as context for the language model.

]

]

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "created_at": "2024-07-29T15:51:28.071Z",
      "description": "string",
      "model": "string",
      "instructions": "string",
      "tools": [
        {},
        {}
      ]
    }
  ]
}

422: Validation Error

application/json

• Schema
• Example (from schema)

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

• MOD1
• MOD2

string

integer

]

msg Message (string)required

type Error Type (string)required

]

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/ai/assistants' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

• 200
• 422

---

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "created_at": "2024-07-29T15:51:28.071Z",
      "description": "string",
      "model": "string",
      "instructions": "string",
      "tools": [
        {},
        {}
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}