workflows

Create Workspace Agent

Save a new tenant-authored agent: a named, reusable prompt the workspace can dispatch later by its stable kebab-case slug. Use when a user wants to capture a custom instruction set as a workspace agent. Rejects a slug that shadows an Amdahl library agent (those ship in code and cannot be replaced) and surfaces tenant slug collisions as a typed conflict.

post/api/platform/v1/agents

Request

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

Request body

slugstring

Optional stable kebab-case dispatch key (lowercase letters, digits, single dashes). Omitted: derived from the name and uniquified automatically.

namestring required

Display name.

descriptionstring

Optional one-line blurb for the agent directory.

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.

promptstring required

The prompt the agent runs with.

Response

Created

dataunknown

Changes

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