Referencia de la API
Referencia generada a partir de la API de producción del 2026-11-14.
| URL base | https://app.openlatch.ai |
| Autenticación | Una clave de API de la organización, enviada como Authorization: Bearer <key> — consulte Autenticación. |
| Errores | Un único sobre para todos los errores, con un código estable — consulte Errores. |
| Cambios | Registro de cambios de la API · Control de versiones |
| Punto de conexión | |
|---|---|
| GET | Listar los agentes conectados a la organización autenticada/api/public/v1/agents |
| DELETE | Eliminar un agente, con sus sesiones, eventos y estadísticas./api/public/v1/agents/{agent_id} |
| GET | Obtener un agente por su ID/api/public/v1/agents/{agent_id} |
| PATCH | Actualizar los campos editables de un agente (por ahora: display_name)./api/public/v1/agents/{agent_id} |
| GET | Grafo de ejecución de un agente beta/api/public/v1/agents/{agent_id}/execution-graph |
| GET | Eventos de un nodo del grafo de ejecución beta/api/public/v1/agents/{agent_id}/execution-graph/node-events |
| GET | Leer la propiedad de un agente/api/public/v1/agents/{agent_id}/ownership |
| PATCH | Reemplazar, vincular o restablecer la propiedad de un agente/api/public/v1/agents/{agent_id}/ownership |
| GET | Leer la lista completa de privilegios concedidos al propietario de un agente/api/public/v1/agents/{agent_id}/ownership/privileges |
| POST | Solicitar una nueva resolución inmediata de la propiedad/api/public/v1/agents/{agent_id}/ownership/recheck |
AIP authoring
Sección titulada «AIP authoring»| Punto de conexión | |
|---|---|
| GET | Leer los metadatos de redacción de AIP beta/api/public/v1/aip/authoring-metadata |
| POST | Start a draft from a source or a preset beta/api/public/v1/aip/drafts |
| DELETE | Descartar un borrador beta/api/public/v1/aip/drafts/{public_id} |
| GET | One draft and its intent policies beta/api/public/v1/aip/drafts/{public_id} |
| PATCH | Save the zones, the mode and the Ask overrides of a draft beta/api/public/v1/aip/drafts/{public_id} |
| DELETE | Take one intent policy out of a draft beta/api/public/v1/aip/drafts/{public_id}/intent-policies/{intent_policy_id} |
| PATCH | Edit one intent policy of a draft beta/api/public/v1/aip/drafts/{public_id}/intent-policies/{intent_policy_id} |
| POST | Answer one interview card beta/api/public/v1/aip/drafts/{public_id}/intent-policies/{intent_policy_id}/answers |
| PATCH | Set the verdict a case should get beta/api/public/v1/aip/drafts/{public_id}/intent-policies/{intent_policy_id}/cases/{index} |
| POST | Ask for a fix beta/api/public/v1/aip/drafts/{public_id}/intent-policies/{intent_policy_id}/fix |
| POST | Apply a drafted fix beta/api/public/v1/aip/drafts/{public_id}/intent-policies/{intent_policy_id}/fix/apply |
| POST | Prepare a revision of a draft beta/api/public/v1/aip/drafts/{public_id}/prepare |
| POST | Ratify and activate a draft beta/api/public/v1/aip/drafts/{public_id}/ratify |
| POST | Replay a draft over past executions beta/api/public/v1/aip/drafts/{public_id}/replay |
| GET | Leer el estado de una tarea de redacción beta/api/public/v1/aip/jobs/{job_id} |
| POST | Importar un documento fuente beta/api/public/v1/aip/sources |
| Punto de conexión | |
|---|---|
| GET | Listar las alertas de seguridad/api/public/v1/alerts |
| DELETE | Eliminar definitivamente una alerta de seguridad/api/public/v1/alerts/{alert_id} |
| PATCH | Descartar una alerta de seguridad/api/public/v1/alerts/{alert_id}/dismiss |
| PATCH | Marcar una alerta de seguridad como leída/api/public/v1/alerts/{alert_id}/read |
| PATCH | Restaurar una alerta de seguridad archivada (descartada)/api/public/v1/alerts/{alert_id}/restore |
| PATCH | Marcar una alerta de seguridad como no leída/api/public/v1/alerts/{alert_id}/unread |
Learning proposals
Sección titulada «Learning proposals»| Punto de conexión | |
|---|---|
| GET | List learning proposals beta/api/public/v1/learning-proposals |
| GET | Read a learning proposal beta/api/public/v1/learning-proposals/{public_id} |
| POST | Accept a learning proposal beta/api/public/v1/learning-proposals/{public_id}/accept |
| POST | Dismiss a learning proposal beta/api/public/v1/learning-proposals/{public_id}/dismiss |
Policies
Sección titulada «Policies»| Punto de conexión | |
|---|---|
| POST | State sentences as a policy/api/public/v1/policies/stated |
| DELETE | Delete a policy/api/public/v1/policies/{public_id} |
| GET | Leer una política ratificada/api/public/v1/policies/{public_id} |
| PATCH | Cambiar el modo de una política en una Autonomy Zone/api/public/v1/policies/{public_id} |
| PATCH | Set a policy's Ask delivery and Ask behaviour beta/api/public/v1/policies/{public_id}/ask-settings |
| POST | Copy a policy to a zone/api/public/v1/policies/{public_id}/copy |
| POST | Edit a policy: open its edit draft/api/public/v1/policies/{public_id}/edit |
| DELETE | Remove a learned case beta/api/public/v1/policies/{public_id}/intent-policies/{intent_policy_id}/cases/{case_id} |
| DELETE | Revoke an intent policy's decisive mark beta/api/public/v1/policies/{public_id}/intent-policies/{intent_policy_id}/decisive |
| POST | Pasar una política a Enforce a partir de una anomalía/api/public/v1/policies/{public_id}/promote |
| PATCH | Rename a policy beta/api/public/v1/policies/{public_id}/title |
| POST | Apply an earlier version of a policy/api/public/v1/policies/{public_id}/versions/{version}/apply |
| GET | Las políticas vigentes en una zona/api/public/v1/zones/{zone_id}/policies |
| POST | Add policies to an Autonomy Zone (removed)/api/public/v1/zones/{zone_id}/policy-attachments |
| DELETE | Remove a policy from an Autonomy Zone (removed)/api/public/v1/zones/{zone_id}/policy-attachments/{public_id} |
Policy presets
Sección titulada «Policy presets»| Punto de conexión | |
|---|---|
| GET | Listar los preajustes de políticas/api/public/v1/policy-presets |
| POST | Create an organization preset beta/api/public/v1/policy-presets |
| DELETE | Delete an organization preset beta/api/public/v1/policy-presets/{key} |
| PATCH | Rename or describe an organization preset beta/api/public/v1/policy-presets/{key} |
| POST | Add rules to an organization preset beta/api/public/v1/policy-presets/{key}/rules |
| DELETE | Remove a rule from an organization preset beta/api/public/v1/policy-presets/{key}/rules/{rule_id} |
Sessions
Sección titulada «Sessions»| Punto de conexión | |
|---|---|
| DELETE | Eliminar todas las sesiones (y sus eventos) de un agente./api/public/v1/agents/{agent_id}/sessions |
| GET | Listar las sesiones de un agente/api/public/v1/agents/{agent_id}/sessions |
| GET | Resumir las sesiones de un agente/api/public/v1/agents/{agent_id}/sessions/summary |
| GET | Inventario de sesiones de la organización (todas las sesiones de todos los agentes, sin deduplicar)/api/public/v1/inventory/sessions |
| DELETE | Eliminar una sesión, con sus eventos y estadísticas./api/public/v1/sessions/{session_id} |
| PATCH | Actualizar los campos editables de una sesión (por ahora: display_name)./api/public/v1/sessions/{session_id} |
| Punto de conexión | |
|---|---|
| GET | Anomalías/api/public/v1/anomalies |
| GET | Detalle de una anomalía/api/public/v1/anomalies/{public_id} |
| PATCH | Modificar una anomalía/api/public/v1/anomalies/{public_id} |
| GET | Listar los elementos Ask/api/public/v1/asks |
| POST | Responder a un elemento Ask/api/public/v1/asks/{ground_id}/answer |
| POST | Posponer un elemento Ask/api/public/v1/asks/{ground_id}/snooze |
| GET | Listar las retenciones/api/public/v1/holds |
| POST | Responder a una retención/api/public/v1/holds/{native_tool_use_id}/answer |
| Punto de conexión | |
|---|---|
| GET | Get the calling user's context/api/public/v1/users/me/context |
| Punto de conexión | |
|---|---|
| DELETE | Restablecer la asignación automática de zona de un agente/api/public/v1/agents/{agent_id}/zone |
| GET | Lo que se aplica a este agente/api/public/v1/agents/{agent_id}/zone |
| PUT | Asignar un agente a una zona a mano/api/public/v1/agents/{agent_id}/zone |
| GET | Listar las unidades organizativas de la organización/api/public/v1/org-units |
| POST | Crear una unidad organizativa manual/api/public/v1/org-units |
| DELETE | Quitar una unidad organizativa manual/api/public/v1/org-units/{unit_id} |
| PATCH | Renombrar o mover una unidad organizativa manual/api/public/v1/org-units/{unit_id} |
| POST | Crear la Autonomy Zone de una unidad organizativa/api/public/v1/org-units/{unit_id}/zone |
| GET | Who would arrive if this unit's Autonomy Zone were enabled/api/public/v1/org-units/{unit_id}/zone/preview |
| GET | Listar las Autonomy Zones de la organización/api/public/v1/zones |
| DELETE | Retirar una Autonomy Zone/api/public/v1/zones/{zone_id} |
| GET | Leer una zona con su pila de capas y sus recuentos/api/public/v1/zones/{zone_id} |
| GET | Agentes asignados directamente a esta zona/api/public/v1/zones/{zone_id}/agents |
| GET | Read a zone's Ask settings beta/api/public/v1/zones/{zone_id}/ask-settings |
| PATCH | Set a zone's Ask settings beta/api/public/v1/zones/{zone_id}/ask-settings |
| DELETE | Revert the default zone to the root/api/public/v1/zones/{zone_id}/default |
| PUT | Make a zone the organization's default zone/api/public/v1/zones/{zone_id}/default |
| GET | The zone's dictionary beta/api/public/v1/zones/{zone_id}/dictionary |
| POST | Add a dictionary table to a zone beta/api/public/v1/zones/{zone_id}/dictionary/tables |
| DELETE | Delete one of a zone's own dictionary tables beta/api/public/v1/zones/{zone_id}/dictionary/tables/{name} |
| DELETE | Delete one of a zone's own dictionary values beta/api/public/v1/zones/{zone_id}/dictionary/tables/{name}/values |
| POST | Add values to a dictionary table beta/api/public/v1/zones/{zone_id}/dictionary/tables/{name}/values |