Skip to main content
POST
Registrar matriz

Autorizações

Authorization
string
header
obrigatório

nia_sk_...

Cabeçalhos

Idempotency-Key
string
obrigatório

Obrigatório. Fica guardado 24 horas com o hash do corpo: repetir com a mesma chave devolve a primeira resposta, e a mesma chave com outro corpo devolve 409 conflict.

Required string length: 1 - 256

Corpo

application/json

Uma organização e a matriz dela: um nível só, então a matriz não tem matriz e a subsidiária não tem subsidiárias. As subsidiárias de uma matriz são contas irmãs, cada uma com a própria memória; uma matriz nunca é uma união. Os dois lados vêm pelo registro da empresa (org_registry_hmac) ou por um id de sistema.

organization
Handle · object
obrigatório

A subsidiária.

parent
Handle · object
obrigatório

Um identificador de um sujeito num canal ou sistema: um telefone, um e-mail, um id do CRM.

method
enum<string>
padrão:declared
Opções disponíveis:
system_import,
declared
valid_from
string<date-time> | null
valid_to
string<date-time> | null

Resposta

A ligação com a matriz, com o perfil de cada lado. Registrar de novo a mesma matriz devolve a ligação que já existe.

method
enum<string>
obrigatório
Opções disponíveis:
system_import,
declared
org_handle_id
string<uuid>
obrigatório

O identificador da subsidiária.

org_profile_id
string<uuid> | null
obrigatório

O perfil da subsidiária agora.

parent_handle_id
string<uuid>
obrigatório
parent_profile_id
string<uuid> | null
obrigatório

O perfil da matriz agora.

valid_from
string<date-time>
obrigatório
valid_to
string<date-time> | null