YYYY-MM-DD). O documento OpenAPI publicado incorpora sua versão de contrato como
info["x-contract-version"], e cada operação declara seu estágio do ciclo de vida
como x-lifecycle-stage (preview, compatibility ou ga).
- A especificação atual está sempre disponível em
/v1-reference/openapi-v1.json. - Os snapshots de referência versionados estão disponíveis em
/v1-reference/openapi/<version>.json, por exemplo/v1-reference/openapi/2026-07-01.json.
Atualizações da documentação
2026-08-25 — Os guias de/v1 e a lista de servers do OpenAPI agora nomeiam os hosts regionais ativos
dos EUA e da UE. Trata-se de um esclarecimento da documentação. A versão do
contrato permanece inalterada. Consulte Regiões.
2026-07-01
A API Pública/v1 oferece suporte a esta versão de contrato. Fixe-a usando
Living-Security-Version: 2026-07-01 ou utilize a versão padrão atribuída
à sua conta de serviço.
Consulte o guia de início rápido da API para fazer sua primeira requisição,
Autenticação para chaves de API e OAuth, e
Regiões para saber qual é o host correto.
2026-08-05
Esta data identifica o contrato de compatibilidade/api/v1 legado, que é separado.
Não é um valor de Living-Security-Version para a nova API /v1.
- Pessoas: pesquise pessoas da organização (
GET /people/search) e recupere a associação de uma pessoa (GET /people/{personId}/membership). - Chaves de acesso à API: crie, liste, faça a rotação e revogue chaves de acesso à API
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility.
Consulte a visão geral da API Pública para
autenticação, paginação e tratamento de erros, e a
política de compatibilidade e descontinuação
para saber como este contrato evolui.
