authed

Read an agent's setup

One AI agent with its newest configuration in full: the model it runs, its system prompt and the tools it may use. That revision may be an unpublished draft; published_revision_id names what is live. Earlier revisions: list_agent_definition_revisions.

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

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}
  • Auth
    none declared

Path parameters

definition_idstring uuid required

The agent's id, as list_agent_definitions returns it.

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.