Agent Life Service API

Interactive reference for the Agent Life Service HTTP API. All endpoints, request/response schemas, and error codes.

Conventions

  • Base URL: https://api.agent-life.ai — all paths below are relative to this URL.
  • Content type: JSON for all request/response bodies unless otherwise specified.
  • User auth: JWT access tokens in Authorization: Bearer <token> and an HttpOnly refresh cookie.
  • Data plane (agents/snapshots/deltas): Either JWT or API key in Authorization.

Non-2xx responses follow a common error structure:

{
  "error": "bad_request | unauthorized | forbidden | not_found | conflict | internal",
  "detail": "Human-readable description"
}

Authentication

API Keys

Invitations

Agent Management

Snapshots

Deltas