assistants

Create a new assistant

Changed on
post/api/v1beta/assistants

Request

  • The document declares no server URL.
  • Auth: bearer_auth (a scheme the document does not define)

Request body

default_chat_providerstring nullable

Default chat provider/model ID for this assistant

descriptionstring nullable

Optional description of the assistant

enforce_facet_settingsboolean

Whether chats derived from this assistant must use the configured facets

facet_idsstring[] nullable

Optional list of facet IDs to configure for this assistant

file_idsstring[] nullable

Optional list of file upload IDs to associate with this assistant

mcp_server_idsstring[] nullable

List of MCP server IDs available to this assistant

namestring required

The name of the assistant

promptstring required

The system prompt for the assistant

Response

Successfully created the assistant

archived_atstring date-time

When this assistant was archived

can_editboolean required

Whether the current user can edit this assistant

This is true for the owner and users with an editor share grant.

created_atstring date-time required

When this assistant was created

default_chat_providerstring

Default chat provider/model ID for this assistant

descriptionstring

Optional description of the assistant

enforce_facet_settingsboolean required

Whether chats derived from this assistant must use the configured facets

facet_idsstring[]

Default facet IDs for chats derived from this assistant

idstring required

The unique ID of the assistant

mcp_server_idsstring[]

List of MCP server IDs available to this assistant

namestring required

The display name of the assistant

owner_emailstring

Optional email of the assistant owner

promptstring required

The system prompt used by the assistant

updated_atstring date-time required

When this assistant was last updated

Changes

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property /// to the response with the status