Admin Dashboard

The admin dashboard API provides cross-workspace visibility into platform resources. All endpoints are under /v1/admin/ and require admin:read authorization.

Aggregate Statistics

Get a summary of resource counts across all workspaces in your tenant.

curl https://api.memorylayer.ai/v1/admin/stats \
  -H "Authorization: Bearer $ML_API_KEY"

Response:

{
  "workspace_count": 12,
  "memory_count": 84230,
  "session_count": 1547,
  "document_count": 328,
  "dataset_count": 15,
  "token_count": 42
}

Resource Listing

The admin API provides paginated listings for five resource types. Each endpoint supports filtering by workspace and by status where applicable.

Common Parameters

Parameter	Type	Default	Description
`workspace_id`	string	—	Filter results to a specific workspace
`status`	string	—	Filter by resource status (where applicable)
`limit`	integer	100	Results per page (max 500)
`offset`	integer	0	Pagination offset

List Memories

curl "https://api.memorylayer.ai/v1/admin/memories?limit=10&offset=0" \
  -H "Authorization: Bearer $ML_API_KEY"

Filter by workspace and status:

curl "https://api.memorylayer.ai/v1/admin/memories?workspace_id=ws-production&status=active&limit=50" \
  -H "Authorization: Bearer $ML_API_KEY"

List Sessions

curl "https://api.memorylayer.ai/v1/admin/sessions?limit=20" \
  -H "Authorization: Bearer $ML_API_KEY"

Include expired sessions (excluded by default):

curl "https://api.memorylayer.ai/v1/admin/sessions?include_expired=true&workspace_id=ws-staging" \
  -H "Authorization: Bearer $ML_API_KEY"

List Documents

curl "https://api.memorylayer.ai/v1/admin/documents?workspace_id=ws-production" \
  -H "Authorization: Bearer $ML_API_KEY"

List Datasets

curl "https://api.memorylayer.ai/v1/admin/datasets?status=ready&limit=50" \
  -H "Authorization: Bearer $ML_API_KEY"

List Jobs

curl "https://api.memorylayer.ai/v1/admin/jobs?status=running" \
  -H "Authorization: Bearer $ML_API_KEY"

Response Format

All resource listing endpoints return a paginated response:

{
  "items": [
    { "...": "resource-specific fields" }
  ],
  "total": 1547,
  "limit": 100,
  "offset": 0
}

Use total to calculate the number of pages. Iterate by incrementing offset by limit:

# Page 1
curl "https://api.memorylayer.ai/v1/admin/memories?limit=100&offset=0" \
  -H "Authorization: Bearer $ML_API_KEY"

# Page 2
curl "https://api.memorylayer.ai/v1/admin/memories?limit=100&offset=100" \
  -H "Authorization: Bearer $ML_API_KEY"

Filtering Patterns

Single workspace audit — Pass workspace_id to focus on one workspace:

curl "https://api.memorylayer.ai/v1/admin/memories?workspace_id=ws-production&limit=500" \
  -H "Authorization: Bearer $ML_API_KEY"

Active resource count — Use the stats endpoint for quick counts, then drill into specific resource types as needed.

Job monitoring — Filter jobs by status to find in-progress or failed operations:

curl "https://api.memorylayer.ai/v1/admin/jobs?status=failed" \
  -H "Authorization: Bearer $ML_API_KEY"