tenancy

GET /v1/orgs/{orgId}

Get an organization.

Todos os endpoints de tenancy

Autenticação

Envie uma chave de API como um token bearer. Este endpoint não especifica uma permissão específica na documentação, portanto, conceda à sua chave o mínimo necessário e verifique a resposta em vez de assumir.

Onde vai o ID da sua organização

Este endpoint aceita o ID da sua organização diretamente na URL, como orgId. Substitua-o no caminho — não há cabeçalho ou parâmetro de consulta que sirva como alternativa.

O ID da sua organização está na tela de chaves de API no seu painel, ao lado da própria chave. É o mesmo ID em todas as chamadas que você fizer.

Experimente

Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.

curl -X GET https://api.zinndigital.com/v1/orgs/{orgId} \
  -H "Authorization: Bearer zdk_live_…"

Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API

Detalhes

Returns a single organization the principal can access. RLS-scoped.

Parâmetros

NomeTipoObrigatórioO que é
orgId (path)UuidSimOrganization ID (UUIDv7).

Resposta

NomeTipoObrigatórioO que é
idUuidSimUUIDv7 identifier — sortable by creation time (docs/02 §8).
typeOrgTypeSimOrganization type in the tenancy tree.
parent_org_idUuid | nullNãoParent in the tenancy tree; null for a top-level org.
namestringSim
brand_idobjectNãoWhite-label brand applied to this org's surfaces.
default_currencyCurrencyCodeSimISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
statusstring<active, suspended, closed>Sim
created_atstringSim

Erros que este endpoint pode retornar

401 · 403 · 404 · 429