Managing Assistants and Threads

Threads and Messages represent a conversation session between an Assistant and a user. There is no limit to the number of Messages you can store in a Thread. When the size of the Messages exceeds the model's context window, the Thread will smartly truncate messages before fully dropping the least important ones.

List your assistants

GEThttps://api.aimlapi.com/assistants

Query parameters

Response

200

Request

JavaScriptCurlPython

const response = await fetch('https://api.aimlapi.com/assistants', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Create your assistant

POSThttps://api.aimlapi.com/assistants

Body

application/json

name*string

description*string

model*string

instructionsstring

metadataobject

Response

201

Request

JavaScriptCurlPython

const response = await fetch('https://api.aimlapi.com/assistants', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "description": "text",
      "model": "text"
    }),
});
const data = await response.json();

Get assistant

GEThttps://api.aimlapi.com/assistants/{assistantId}

Path parameters

assistantId*string

Response

200

Request

JavaScriptCurlPython

const response = await fetch('https://api.aimlapi.com/assistants/{assistantId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Update assistant

POSThttps://api.aimlapi.com/assistants/{assistantId}

Path parameters

assistantId*string

Body

application/json

namestring

descriptionstring

modelstring

instructionsstring

metadataobject

Response

201

Request

JavaScriptCurlPython

const response = await fetch('https://api.aimlapi.com/assistants/{assistantId}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();