Référence de l’API

Référence générée à partir de l’API de production du 2026-11-14.

URL de base	https://app.openlatch.ai
Authentification	Une clé d’API d’organisation, envoyée dans Authorization: Bearer <key> — voir Authentification.
Erreurs	Une seule enveloppe pour toutes les erreurs, avec un code stable — voir Erreurs.
Évolutions	Journal des modifications de l’API · Gestion des versions

Agents

	Point de terminaison
GET	Lister les agents connectés à l’organisation authentifiée /api/public/v1/agents
DELETE	Supprimer un agent, avec ses sessions, ses événements et ses statistiques. /api/public/v1/agents/{agent_id}
GET	Obtenir un agent par son ID /api/public/v1/agents/{agent_id}
PATCH	Modifier les champs modifiables d’un agent (actuellement : display_name). /api/public/v1/agents/{agent_id}
GET	Graphe d’exécution d’un agent beta /api/public/v1/agents/{agent_id}/execution-graph
GET	Événements d’un nœud du graphe d’exécution beta /api/public/v1/agents/{agent_id}/execution-graph/node-events
GET	Lire le propriétaire d’un agent /api/public/v1/agents/{agent_id}/ownership
PATCH	Remplacer, lier ou réinitialiser le propriétaire d’un agent /api/public/v1/agents/{agent_id}/ownership
GET	Lire la liste complète des privilèges accordés au propriétaire d’un agent /api/public/v1/agents/{agent_id}/ownership/privileges
POST	Demander une nouvelle résolution immédiate du propriétaire /api/public/v1/agents/{agent_id}/ownership/recheck

AIP authoring

	Point de terminaison
GET	Lire les métadonnées de rédaction des 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	Abandonner un brouillon 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	Lire l’état d’une tâche de rédaction beta /api/public/v1/aip/jobs/{job_id}
POST	Importer un document source beta /api/public/v1/aip/sources

Alerts

	Point de terminaison
GET	Lister les alertes de sécurité /api/public/v1/alerts
DELETE	Supprimer définitivement une alerte de sécurité /api/public/v1/alerts/{alert_id}
PATCH	Écarter une alerte de sécurité /api/public/v1/alerts/{alert_id}/dismiss
PATCH	Marquer une alerte de sécurité comme lue /api/public/v1/alerts/{alert_id}/read
PATCH	Restaurer une alerte de sécurité archivée (écartée) /api/public/v1/alerts/{alert_id}/restore
PATCH	Marquer une alerte de sécurité comme non lue /api/public/v1/alerts/{alert_id}/unread

Learning proposals

	Point de terminaison
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

	Point de terminaison
POST	State sentences as a policy /api/public/v1/policies/stated
DELETE	Delete a policy /api/public/v1/policies/{public_id}
GET	Lire une politique ratifiée /api/public/v1/policies/{public_id}
PATCH	Changer le mode d’une politique dans une 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	Passer une politique en Enforce sur la foi d’une anomalie /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	Les politiques en vigueur dans une zone /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

	Point de terminaison
GET	Lister les préréglages de politiques /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

	Point de terminaison
DELETE	Supprimer toutes les sessions (et leurs événements) d’un agent. /api/public/v1/agents/{agent_id}/sessions
GET	Lister les sessions d’un agent /api/public/v1/agents/{agent_id}/sessions
GET	Résumer les sessions d’un agent /api/public/v1/agents/{agent_id}/sessions/summary
GET	Inventaire des sessions de l’organisation (toutes les sessions de tous les agents, sans dédoublonnage) /api/public/v1/inventory/sessions
DELETE	Supprimer une session, avec ses événements et ses statistiques. /api/public/v1/sessions/{session_id}
PATCH	Modifier les champs modifiables d’une session (actuellement : display_name). /api/public/v1/sessions/{session_id}

Triage

	Point de terminaison
GET	Anomalies /api/public/v1/anomalies
GET	Détail d’une anomalie /api/public/v1/anomalies/{public_id}
PATCH	Modifier une anomalie /api/public/v1/anomalies/{public_id}
GET	Lister les éléments Ask /api/public/v1/asks
POST	Répondre à un élément Ask /api/public/v1/asks/{ground_id}/answer
POST	Reporter un élément Ask /api/public/v1/asks/{ground_id}/snooze
GET	Lister les mises en attente /api/public/v1/holds
POST	Répondre à une mise en attente /api/public/v1/holds/{native_tool_use_id}/answer

Users

	Point de terminaison
GET	Get the calling user's context /api/public/v1/users/me/context

Zones

	Point de terminaison
DELETE	Rétablir l’affectation automatique de zone d’un agent /api/public/v1/agents/{agent_id}/zone
GET	Ce qui s’applique à cet agent /api/public/v1/agents/{agent_id}/zone
PUT	Affecter un agent à une zone à la main /api/public/v1/agents/{agent_id}/zone
GET	Lister les unités organisationnelles de l’organisation /api/public/v1/org-units
POST	Créer une unité organisationnelle manuelle /api/public/v1/org-units
DELETE	Retirer une unité organisationnelle manuelle /api/public/v1/org-units/{unit_id}
PATCH	Renommer ou déplacer une unité organisationnelle manuelle /api/public/v1/org-units/{unit_id}
POST	Créer l’Autonomy Zone d’une unité organisationnelle /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	Lister les Autonomy Zones de l’organisation /api/public/v1/zones
DELETE	Retirer une Autonomy Zone /api/public/v1/zones/{zone_id}
GET	Lire une zone avec sa pile de couches et ses décomptes /api/public/v1/zones/{zone_id}
GET	Agents affectés directement à cette zone /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