Workspaces da agência

GET 
/workspaces

O grupo de uma agência: a própria conta e um workspace por cliente, todos na mesma assinatura, com o que cada um consumiu no período de cobrança — números conectados, contatos e mensagens. É o que uma integração usa para repassar o custo a cada cliente.

Só a chave sem restrição de números da conta da agência lê o grupo. Uma chave limitada a números recebe 403, e a chave de um workspace recebe 409 not_principal: um cliente não fica sabendo dos outros.

Criar, renomear e excluir workspaces é feito no painel, não pela API.

Responses

200

O grupo.

401

Token ausente, malformado, desconhecido ou revogado (authentication), ou conta suspensa (tenant_inactive).

403

O recurso informado não pertence à sua conta (forbidden), ou o caminho está na lista de bloqueio do espelho (forbidden_endpoint), ou a sua API key é restrita a alguns números e a operação é da conta inteira (forbidden).

409

Conflito com o estado atual da conta.

429

Limite de requisições excedido (rate_limit).

Response Headers

Retry-After

Segundos a aguardar antes de tentar de novo.

X-RateLimit-Category

Categoria do limite aplicada — send, media ou default.

X-RateLimit-Scope

Qual balde os outros headers descrevem — key (a API key), session (o painel) ou account (o teto da conta).

X-RateLimit-Limit

Teto de requisições da categoria na janela atual.

X-RateLimit-Remaining

Requisições restantes na janela atual.