Referencia de API
La definición completa y legible por máquina de la Maetra API vive en openapi.yaml (OpenAPI 3.1). Cubre a Govern, Secure, Task Guard, Agentes y operaciones del sistema.
Nota Sacando la especificaciones en GitBook. Añada el archivo OpenAPI como fuente de referencia de API: Configuración de la organización → Integraciones → OpenAPI, subir
openapi.yaml(o punto en una URL hospedada), a continuación, insertar un Bloque OpenAPI en esta página.
Operaciones#
Todos los puntos finales se sirven desde https://api.maetra.io y requieren un Clave de la API de portador a menos que se indique.
Govern
| Método | Camino | Ámbito | Docs |
|---|---|---|---|
POST | /v1/checkpoints | govern:checkpoints:write | Puntos de control |
GET | /v1/checkpoints/{id} | govern:checkpoints:read | Puntos de control |
GET | /v1/checkpoints/{id}/wait | govern:checkpoints:read | Puntos de control |
GET | /v1/policies/active | govern:policies:read | Políticas |
Secure
| Método | Camino | Ámbito | Docs |
|---|---|---|---|
GET | /v1/secure/rules | secure:rules:read | Reglas |
POST | /v1/secure/rules | secure:rules:write | Reglas |
PATCH | /v1/secure/rules/{id} | secure:rules:write | Reglas |
POST | /v1/secure/scan | secure:scan:write | Contenido de exploración |
GET | /v1/secure/incidents | secure:incidents:read | Incidentes |
Agentes
| Método | Camino | Ámbito | Docs |
|---|---|---|---|
GET | /v1/agents | discover:agents:read | Agentes |
Task Guard
| Método | Camino | Ámbito | Docs |
|---|---|---|---|
POST | /v1/task-guard/tools/{tool} | Depende de la herramienta | Task Guard API |
POST | /v1/task-guard/sessions | task_guard:tasks:write | Tareas y contexto |
POST | /v1/task-guard/tasks | task_guard:tasks:write | Tareas y contexto |
POST | /v1/task-guard/sessions/{sessionId}/user-events | task_guard:confirmations:write + confianza credencial | Tareas y contexto |
GET | /v1/task-guard/tasks/{taskId} | task_guard:tasks:read | Tareas y contexto |
GET | /v1/task-guard/tasks/{taskId}/context | task_guard:tasks:read | Tareas y contexto |
POST | /v1/task-guard/tasks/{taskId}/progress | task_guard:tasks:write | Tareas y contexto |
POST | /v1/task-guard/tasks/{taskId}/pause | task_guard:tasks:write | Tareas y contexto |
POST | /v1/task-guard/tasks/{taskId}/resume | task_guard:tasks:write | Tareas y contexto |
POST | /v1/task-guard/tasks/{taskId}/cancel | task_guard:tasks:write | Tareas y contexto |
POST | /v1/task-guard/tasks/{taskId}/complete | task_guard:tasks:write | Tareas y contexto |
POST | /v1/task-guard/tasks/{taskId}/checks | task_guard:checks:write | Alineación y efectos |
POST | /v1/task-guard/tasks/{taskId}/changes | task_guard:checks:write | Alineación y efectos |
POST | /v1/task-guard/checks/{checkId}/explanation | task_guard:checks:write | Alineación y efectos |
POST | /v1/task-guard/checks/{checkId}/effects | task_guard:effects:write | Alineación y efectos |
POST | /v1/task-guard/changes/{proposalId}/confirmation | task_guard:confirmations:write + confianza credencial | Alineación y efectos |
POST | /v1/task-guard/alignment/verify | task_guard:checks:write | Alineación y efectos |
Sistema
| Método | Camino | Auth | Docs |
|---|---|---|---|
GET | /v1/ping | Cualquier clave válida | Autenticación |
GET | /.well-known/jwks.json | Ninguno | Tokens de decisión |