Agent Life Service API

Interactive reference for the Agent Life Service HTTP API. All endpoints, request/response schemas, and error codes. Sign in or paste an API key below to use Try It on live endpoints.

Conventions

  • Base URL: https://api.agent-life.ai — paths below are appended as-is (no /v1 segment on the custom domain; the deployment stage is mapped at the root). The default *.execute-api.*.amazonaws.com/v1/... URL still includes /v1 before a custom domain is configured.
  • Content type: JSON for all request/response bodies unless otherwise specified.
  • Authentication:
    • 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 (see below).
  • Errors: Non-2xx responses follow a common structure:
{
  "error": "bad_request | unauthorized | forbidden | not_found | conflict | internal",
  "detail": "Human-readable description"
}

Authentication

API Keys

Invitations

Agent Management

Agent Data (Dashboard)

Snapshots

Deltas