Sign in
job

run a saved AI agent

Changed on

Runs the ai_agent resource at path as stored, for any caller who can read it (operators included), as the caller, who needs access to the agent's AI resource and to whatever its tools use. With memory_id, the run is a turn of the caller's conversation with the agent; without, a single run.

post/w/{workspace}/jobs/run/agent/{path}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/w/{workspace}/jobs/run/agent/{path}
  • Auth: one of:
    • HTTP bearer
    • API key in cookie token

Path parameters

workspacestring required
pathstring required

Query parameters

memory_idstring

The conversation this turn belongs to. A uuid is used as is; any other string is hashed within the workspace and agent.

Request body

user_messagestring

Response

job created

Changes