YYYY-MM-DD). El documento OpenAPI publicado incorpora su versión de contrato como
info["x-contract-version"], y cada operación declara su etapa del ciclo de vida
como x-lifecycle-stage (preview, compatibility o ga).
- La especificación actual siempre está disponible en
/v1-reference/openapi-v1.json. - Las instantáneas de referencia versionadas están disponibles en
/v1-reference/openapi/<version>.json, por ejemplo/v1-reference/openapi/2026-07-01.json.
Actualizaciones de la documentación
2026-08-25 — Las guías de/v1 y la lista servers de OpenAPI ahora indican los
hosts regionales activos de EE. UU. y la UE. Se trata de una aclaración de la documentación. La versión
de contrato no ha cambiado. Consulte Regiones.
2026-07-01
La API pública de/v1 admite esta versión de contrato. Fíjela mediante
Living-Security-Version: 2026-07-01 o utilice la versión predeterminada asignada
a su cuenta de servicio.
Consulte la guía de inicio rápido de la API para realizar su primera solicitud,
Autenticación para las claves de API y OAuth, y
Regiones para conocer el host correcto.
2026-08-05
Esta fecha identifica el contrato de compatibilidad/api/v1 heredado y independiente.
No es un valor de Living-Security-Version para la nueva API de /v1.
- Personas: buscar personas de la organización (
GET /people/search) y recuperar la pertenencia de una persona (GET /people/{personId}/membership). - Claves de acceso a la API: crear, enumerar, rotar y revocar claves de acceso a la API
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility.
Consulte la descripción general de la API pública para
la autenticación, la paginación y la gestión de errores, y la
política de compatibilidad y obsolescencia
para saber cómo evoluciona este contrato.