Levain LabsLevain Labs
ApiManaged agents

Adopt Managed Agent

Adopt a managed agent into the workspace.

The agent appears in GET /api/v1/agents with kind managed and is immediately active: it can be run, talked to, scheduled, and paused like any other agent, while Levain maintains its behaviour.

Rejected with 409 when the workspace has already adopted this agent or is missing a required integration — connect the listed providers first. Rejected with 403 on plans that only include the Levain assistant (adopting other agents starts on the Team plan).

POST
/api/v1/managed-agents/{slug}/adopt

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Path Parameters

slug*Slug

Header Parameters

X-API-Key?string|null

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://api.levainlabs.com/api/v1/managed-agents/string/adopt" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "status": "string",
  "icon": "string",
  "color": "string",
  "kind": "customer",
  "config": {
    "max_budget": 1,
    "timeout_minutes": 1,
    "notify_on_run": true,
    "workspace_scope": "session"
  },
  "created_at": "string",
  "updated_at": "string",
  "draft_version": 0,
  "open_issue_count": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}