Create assistant file (v1)

POST

https://api.openai.com/v1/assistants/asst_abc123/files

Create an assistant file by attaching a File to an assistant.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.openai.com/v1/assistants/asst_abc123/files' \
--header 'Authorization: Bearer $OPENAI_API_KEY"' \
--header 'OpenAI-Beta: assistants=v1' \
--header 'Content-Type: application/json' \
--data-raw '{
      "file_id": "file-abc123"
    }'

Response Example

{
  "id": "file-abc123",
  "object": "assistant.file",
  "created_at": 1699055364,
  "assistant_id": "asst_abc123"
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Authorization

string

required

Example:

Bearer $OPENAI_API_KEY"

Content-Type

string

required

Example:

application/json

OpenAI-Beta

string

required

Example:

assistants=v1

Body Params application/json

file_id

string

required

A File ID (with purpose="assistants") that the assistant should use. Useful for tools like retrieval and code_interpreter that can access files.

Examples

Responses

🟢200Success

application/json

Body

string

required

object

string

required

created_at

integer

required

assistant_id

string

required

Create assistant (v1)

List assistants (v1)