pods

Create pod

Create a new multi-tenant pod. Only platform keys (al_live_...) can create pods. Returns a pod API key (al_pod_...) for use by downstream agents.

post/v1/pods

Request

  • Base URL: https://agentlair.dev
  • URL: https://agentlair.dev/v1/pods
  • Auth: HTTP bearer

Request body

namestring

Optional label for the pod

Example request

{
  "name": "customer-123",
  "rate_limits": {
    "requests_per_minute": 60,
    "requests_per_hour": 1000,
    "requests_per_day": 10000
  },
  "spending_caps": {
    "daily": 1000000,
    "weekly": 5000000,
    "monthly": 20000000
  }
}

Response

Pod created

pod_idstring
api_keystring

Pod API key — save immediately, not shown again

namestring nullable
status'active' | 'suspended'
created_atstring date-time

Example response

{
  "pod_id": "pod_abc123def456",
  "api_key": "al_pod_k7x9m2p4abcdefghijklmnopqrstuvwxyz12",
  "name": "customer-123",
  "rate_limits": {
    "requests_per_minute": 60,
    "requests_per_hour": 1000,
    "requests_per_day": 10000
  },
  "spending_caps": {
    "daily": 1000000,
    "weekly": 5000000,
    "monthly": 20000000
  }
}

Changes

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