API Reference

The Poliglot API lets you manage workspaces, contexts, matrices, packages, secrets, IAM, and more.

Base URL

https://poliglot.io/api/v1/

All requests require a Personal Access Token sent as a Bearer token:

curl -H "Authorization: Bearer plgt_your_token_here" \
  https://poliglot.io/api/v1/workspaces

All responses use the standard envelope:

{
  "success": true,
  "data": { ... }
}

Error responses:

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Workspace not found: my-workspace"
  }
}

Paginated endpoints accept page (0-based) and pageSize query parameters:

curl "https://poliglot.io/api/v1/matrix/my-workspace?page=0&pageSize=20" \
  -H "Authorization: Bearer plgt_your_token_here"

Paginated responses include:

{
  "success": true,
  "data": {
    "content": [ ... ],
    "page": 0,
    "pageSize": 20,
    "totalElements": 47,
    "totalPages": 3
  }
}

Code	Description
`200`	Success
`400`	Bad request (validation error, missing parameter)
`401`	Unauthorized (missing or invalid token)
`403`	Forbidden (insufficient permissions)
`404`	Resource not found
`409`	Conflict (duplicate resource, version mismatch)
`429`	Rate limited
`500`	Internal server error

See the endpoint reference for the full list of available operations.