TEteaflask
authed

Create an agent

Create a new AI agent from a name and a whole configuration. It starts as an unpublished draft, never live, until published with publish_agent_definition. A name another agent already holds is refused, and a refused configuration is described problem by problem; either way nothing is stored.

post/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

Request body

namestring required

The agent's display name; its unique short name is made from it.

kind'web' | 'slack'

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

configobject required

The agent's whole configuration, "version": "agent/v1", shaped like get_agent_definition's latest_revision.config.

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.