Autenticação

Use uma chave criada em Perfil e selecione o destino de cada operação.

Criar a credencial

Acesse Perfil → API e integrações, escolha os workspaces e conceda somente as permissões necessárias. A validade e a restrição por IP são opcionais. A chave completa aparece apenas na criação.

Descobrir destinos autorizados

curl https://api.usematias.com/v1/integrations/context \
  -H "x-api-key: SUA_CHAVE"

A resposta informa os IDs, tipos e permissões efetivas dos workspaces autorizados. Essa é a única rota que não exige um destino.

Fazer operações de negócio

curl https://api.usematias.com/v1/financial-records \
  -H "x-api-key: SUA_CHAVE" \
  -H "X-Workspace-Id: UUID_DO_WORKSPACE"

O backend valida o workspace e o scope em cada chamada. Trocar o workspace aberto na interface não muda o destino da API.