Provisionamento de organizações
Cadastrar um novo cliente do seu produto costuma significar várias gravações que precisam ter sucesso juntas. O provisionamento as faz em uma só chamada.
O que uma chamada cria
A chamada cria a organização e a sua marca. Ela também pode criar o registro de configurações da organização, adicionar seu primeiro membro e emitir uma chave de API confinada a ela. Você escolhe quais dessas etapas incluir.
Seguro para repetir
Você fornece um id para o provisionamento. Enviar o mesmo id com a mesma requisição retoma a partir da primeira etapa que não terminou, e um provisionamento que já foi concluído não faz nada. Duas chamadas feitas no mesmo instante produzem uma só organização.
A chave é mostrada uma vez
Se você pedir uma chave, o segredo dela volta na chamada que a emitiu e nunca mais, porque o Fóir armazena apenas um hash. As permissões da chave são limitadas às da credencial que a solicitou.
De onde você pode chamar
O provisionamento está disponível pela API, pela CLI como foir orgs provision, e para um agente conectado por MCP. Cada etapa exige a permissão que a sua própria gravação exigiria, então uma credencial que pode criar organizações não pode usar o provisionamento para emitir uma chave, a menos que também possa gerenciar chaves.
Leia os detalhes
O guia de provisionamento lista cada etapa, a permissão de que cada uma precisa e o que uma nova tentativa retorna.