Skip to content
UltimateTeam.ai Docs

Request a new specialist agent

POST
/api/v1/forge/agent

Dispatch an AgentForge build job and return a job_id to poll for status.

Authorizations

Request Body required

Request body for POST /forge/agent.

Attributes: description: Natural-language description of the specialist needed.

object
description
required

Natural-language description of the specialist (e.g. ‘I need a TikTok marketing specialist’)

string
>= 1 characters

Responses

202

Successful Response

Typed envelope for POST /forge/agent and POST /forge/connector (202).

object
data
required

Envelope returned on successful job submission (202).

Attributes: job_id: UUID of the queued forge job. status: Always ‘pending’ at submission time.

object
job_id
required
string
status
string
default: pending

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string