Sign in
Agents

Save changes

Changed on

Save changes stores this agent's name, purpose, model, and tools.

put/v1/agents/{slug}

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/agents/{slug}
  • Auth: HTTP bearer

Path parameters

slugstring required

Agent id.

Example:acme-follow-up

Request body

apiVersionstring required

Document version.

kindstring required

Document kind.

Example request

{
  "apiVersion": "agent.rowboat.dev/v1",
  "kind": "Agent",
  "metadata": {
    "name": "Acme follow-up",
    "slug": "acme-follow-up"
  },
  "spec": {
    "instructions": "Draft the next follow-up for Acme.",
    "model": "openai/gpt-4.1-mini",
    "provider": "openrouter",
    "tools": [
      "relationship.read"
    ]
  }
}

Response

The agent is saved.

enabledToolsstring[] required

Tools this agent can use.

instructionsstring

Purpose shown for this agent.

modelstring

Model this agent uses.

namestring required

Name on the agents page.

providerstring

Where that model runs.

slugstring required

Agent id.

sourcestring required

tenant means this workspace owns the agent.

Example response

{
  "enabledTools": [
    "relationship.read"
  ],
  "instructions": "Draft the next follow-up for Acme.",
  "model": "openai/gpt-4.1-mini",
  "name": "Acme follow-up",
  "provider": "openrouter",
  "slug": "acme-follow-up",
  "source": "tenant"
}

Changes