TEteaflask
authed

Read an agent's history

One agent's configuration revisions, newest first, each in full; get_agent_definition returns only the newest. A full page means more may exist.

get/api/v1/agent-definitions/{definition_id}/revisions

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/{definition_id}/revisions
  • Auth
    none declared

Path parameters

definition_idstring uuid required

The agent's id, as list_agent_definitions returns it.

Query parameters

before_created_atstring date-time nullable

With before_id: the last row of the previous page's created_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 revisions to return.

Response

Successful Response

idstring uuid required

The revision's id.

agent_definition_idstring uuid required

The agent it belongs to.

parent_revision_idstring uuid nullable required

The revision this one was edited from; null for the first.

configobject required

The agent's whole configuration: model (which model answers and how hard it thinks), routing (fallback models) and user_model_choice (whether visitors may pick the model); prompt (its system prompt); tools (what it may use: searching and reading docs, navigating, reading, highlighting and filling in pages of the organization's own app, calling the organization's API actions by slug, handing work to subagents, a code workspace, the page register); docs_scope and skills (which docs and skills it may read); memory (whether it remembers each signed-in visitor); suggestions (first questions offered to visitors); end_users (whether visitors must sign in or connect an AI subscription, and what they may spend before one is required); and steering and interventions (the checks that steer or stop its actions).

config_format'agent/v1' required

Versions of the agent config vocabulary; evolves additively, never in place.

status'draft' | 'published' | 'superseded' required
authored_by_user_idstring uuid required

The member who wrote it.

content_versioninteger required

Changes each time this revision is edited in place; send it back as parent_content_version.

created_atstring date-time required

When the revision was created.

updated_atstring date-time required

When the revision last changed: an edited draft or a status change.

Changes

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