Levain LabsLevain Labs
API ReferenceAgents

Create Agent

Create an agent shell.

The agent has no recipe repo or version until POST /{id}/versions is called. This keeps repo provisioning on a single creation path.

POST
/api/v1/agents/

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Header Parameters

X-API-Key?|

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/agents/" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "workspace_id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "status": "string",
  "created_at": "string",
  "updated_at": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}