Sign in
assistants

Update an existing assistant

Changed on
put/api/v1beta/assistants/{assistant_id}

Request

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

Path parameters

assistant_idstring required

The ID of the assistant to update

Request body

default_chat_providerstring nullable

Optional new default chat provider

descriptionstring nullable

Optional new description for the assistant

enforce_facet_settingsboolean nullable

Optional new enforcement flag for assistant facet settings

facet_idsstring[] nullable

Optional new list of facet IDs for this assistant

file_idsstring[] nullable

Optional list of file upload IDs to associate with this assistant

mcp_server_idsstring[] nullable

Optional new list of MCP server IDs

namestring nullable

Optional new name for the assistant

promptstring nullable

Optional new prompt for the assistant

Response

Successfully updated 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

  • da255ff2b71aRevision changes
    • info

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

  • 14aa9d12afa0Revision changes
    • info

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