workflows

Update Workspace Agent

Revise a tenant-authored agent's name, description, or prompt in place, keeping its slug stable. Call when refining how a saved agent behaves after seeing its output. Amdahl library agents are code-defined and immutable, so edits targeting one are refused with a locked error rather than silently ignored.

patch/api/platform/v1/agents/{id}

Request

  • Base URL: https://docs.amdahl.ai
  • URL: https://docs.amdahl.ai/api/platform/v1/agents/{id}
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

UUID or slug of the agent to patch.

Request body

namestring

New display name.

descriptionstring

New directory blurb.

promptstring

New prompt body.

tool_blockliststring[]

Operation ids to subtract from this agent tool kit at run time (all kit tools are on by default; empty list = no restriction). Runner-inline tools are refused.

Response

OK

dataunknown

Changes

No recorded changes to this operation across all 1 revision of this API.