Retrieve assistant

GEThttps:/api.openai.com/v1/assistants/{assistant_id}

Retrieves an assistant.

Path parameters

  • assistant_id
    string
    Required
    The ID of the assistant to retrieve.

Response

The assistant object matching the specified ID.

Example request
1
curl https://api.openai.com/v1/assistants/asst_abc123 \

2
  -H "Content-Type: application/json" \

3
  -H "Authorization: Bearer $OPENAI_API_KEY" \

4
  -H "OpenAI-Beta: assistants=v2"
Example response
1
{

2
  "id": "asst_abc123",

3
  "object": "assistant",

4
  "created_at": 1699009709,

5
  "name": "HR Helper",

6
  "description": null,

7
  "model": "gpt-4o",

8
  "instructions": "You are an HR bot, and you have access to files to answer employee questions about company policies.",

9
  "tools": [

10
    {

11
      "type": "file_search"

12
    }

13
  ],

14
  "metadata": {},

15
  "top_p": 1.0,

16
  "temperature": 1.0,

17
  "response_format": "auto"

18
}
Built with