Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.litellm-agent-platform.ai/llms.txt

Use this file to discover all available pages before exploring further.

The LiteLLM Agent Platform (LAP) REST API lets you create and configure agents, open isolated sandbox sessions, send messages, and manage skills and memories — all from your own scripts or services.

​
Base URL

All endpoints are relative to your platform’s deployment URL: 
https://<your-platform-host>/api/v1/managed_agents
Skill endpoints use a slightly different prefix: 
https://<your-platform-host>/api/v1/skills

​
Authentication

Every request must carry a Bearer token in the Authorization header. The token is the MASTER_KEY value set in your platform’s environment configuration. 
Authorization: Bearer <MASTER_KEY>
A missing or incorrect token returns 401 Unauthorized.

​
Example request

curl https://<your-platform-host>/api/v1/managed_agents/agents \
  -H "Authorization: Bearer $MASTER_KEY"

​
Response format

All successful responses return JSON. Error responses have this shape: 
{ "error": "description of what went wrong" }
Common HTTP status codes:
StatusMeaning
200Success
201Resource created
204Success, no body
400Validation error in request body
401Missing or invalid Authorization header
404Resource not found
500Internal server error
502Harness unreachable (sandbox-side failure)

​
Pagination

List endpoints accept limit and offset query parameters and return a paginated envelope:
​
data
array
The page of results.
​
total
number
Total number of records matching the query.
​
limit
number
The effective page size used for this response.
​
offset
number
The offset used for this response.
ParameterTypeDefaultMax
limitinteger50200
offsetinteger0—

​
Sections

Agents

Create, read, update, and delete agent configurations.

Sessions

Spawn sandbox pods, send messages, and stop sessions.

Skills

Build reusable instruction sets and attach them to agents.

Memory

Store and retrieve per-agent memory entries.