FIfish
Agents

Create Agent

Changed on

Create an agent, optionally with its full initial configuration inline — one call provisions a ready-to-publish agent. The agent starts as a draft: publish it before creating sessions with it.

post/v1/agent/agents

Request

  • Base URL
    https://api.fish.audio
  • URL
    https://api.fish.audio/v1/agent/agents
  • Auth
    HTTP bearer

Request body

namestring required
descriptionstring

Response

Document created, URL follows

agent_idstring required
workspace_idstring required
namestring required
descriptionstring
status'active' | 'archived' required
publication_state'live' | 'draft' required

live once at least one version is published; draft agents cannot take sessions yet.

public_enabledboolean
allowed_originsstring[]
overrides_allowedstring[]
created_atstring date-time required
updated_atstring date-time required

Changes