YYYY-MM-DD). O documento OpenAPI publicado incorpora a sua versão de contrato como
info["x-contract-version"], e cada operação declara o 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 instantâneos 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 indicam os hosts regionais ativos
dos EUA e da UE. Trata-se de um esclarecimento da documentação. A versão
de contrato permanece inalterada. Consulte Regiões.
2026-07-01
A API Pública/v1 é compatível com esta versão de contrato. Fixe-a utilizando
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 a sua primeira requisição,
Autenticação para chaves de API e OAuth, e
Regiões para o host correto.
2026-08-05
Esta data identifica o contrato de compatibilidade legado/api/v1 separado.
Não é um valor de Living-Security-Version para a nova API /v1.
- Pessoas: pesquisar pessoas da organização (
GET /people/search) e obter a associação de uma pessoa (GET /people/{personId}/membership). - Chaves de acesso à API: criar, listar, rotacionar e revogar 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.
