Sign in
assistants

List all assistants available to the user

get/api/v1beta/assistants

Request

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

Query parameters

sharing_relationstring

Filter assistants by sharing relation

  • all (default): All assistants are listed
  • owned_by_user: Only assistants owned by the user
  • shared_with_user: Only assistants shared with the user (= all - owned_by_user)
include_archivedboolean

Whether to include archived assistants. Defaults to false.

Response

Successfully retrieved user's assistants

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

No recorded changes to this operation across all 51 revisions of this API.