List assistants | OpenAI API (unofficial showcase)

4 parameters

limitintegeroptional

Maximum number of assistants to return, from 1 to 100. Defaults to 20 when omitted.

Default:20

orderstringoptional

Sort order by creation time: `asc` or `desc`. Defaults to `desc` when omitted.

Allowed:ascdescDefault:desc

afterstringoptional

Cursor identifying the last assistant on the previous page; use it to retrieve the next page.

beforestringoptional

Cursor identifying the first assistant on the current page; use it to retrieve the previous page.

2 status codes

200Returns a list of assistant objects with pagination cursors and a `has_more` indicator.

objectstringrequired

dataarray<Assistant>required

first_idstringrequired

last_idstringrequired

has_morebooleanrequired

429Returned when the request is rejected because a rate limit was exceeded.

errorobjectrequired

Error handling

A 429 is returned when the request exceeds the rate limit. limit must be between 1 and 100, and order must be asc or desc.

import { Client } from "openai-api";

const client = new Client({
  baseUrl: "https://api.openai.com/v1",
  auth: { bearer: process.env.API_TOKEN },
});

const result = await client.assistants.list({
  limit: 20,
  order: "example",
  after: "example",
  before: "example",
});

{
  "object": "list",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "object": "assistant",
      "created_at": 1,
      "name": "Example Name",
      "description": "Example description",
      "model": "example_value",
      "instructions": "example_value",
      "tools": [],
      "tool_resources": {
        "code_interpreter": {
          "file_ids": []
        },
        "file_search": {
          "vector_store_ids": [
            null
          ]
        }
      },
      "temperature": 1,
      "top_p": 1,
      "response_format": "auto"
    }
  ],
  "first_id": "asst_abc123",
  "last_id": "asst_abc456",
  "has_more": false
}

Request

Response

Errors