authed

List agents

The AI agents the organization has configured, most recently changed first — names and ids, no configuration. Read one agent's model, prompt and tools with get_agent_definition. A full page means more may exist.

get/api/v1/agent-definitions

Request

  • Base URL
    https://api.teaflask.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.teaflask.com/api/v1/agent-definitions
  • Auth
    none declared

Query parameters

before_updated_atstring date-time nullable

With before_id: the last row of the previous page's updated_at, to read the next page.

before_idstring uuid nullable

With the sort cursor: the last row of the previous page's id.

limitinteger

The most agents to return.

Response

Successful Response

idstring uuid required

The agent's id.

organization_idstring uuid required

The organization it belongs to.

slugstring required

The agent's unique short name.

namestring required

The agent's display name.

kind'web' | 'slack' required

Where an agent answers; chosen at creation and never switched.

published_revision_idstring uuid nullable required

The revision live conversations run; null until the agent is first published.

created_atstring date-time required

When the agent was created.

updated_atstring date-time required

When the agent last changed.

Changes

No recorded changes to this operation across all 1 revision of this API.