Organizações e usuários

Provedores e clientes usam https://api.hashiro.ai/api/ com X-HASHIRO-TOKEN. Permissões de organização não dão acesso a organizações arbitrárias.

Rotas

Método	Caminho	Operação
GET	/users/me	Consultar próprio usuário
PATCH	/users/me	Atualizar perfil
PATCH	/users/me/appearance	Atualizar tema e idioma
GET	/organizations/me	Consultar própria organização
PATCH	/organizations/me	Atualizar própria organização
GET	/organizations/customers	Listar vínculos autorizados
GET	/organizations/:organizationId	Consultar organização autorizada
POST	/organizations/clients	Provedor: criar cliente e usuário inicial
DELETE	/organizations/:organizationId	Provedor: excluir cliente provisionado ainda não reivindicado
POST	/organizations/me/deletion-request	Solicitar exclusão da própria organização
GET	/users/	Listar usuários da organização
GET	/users/:organizationId	Listar usuários de organização vinculada permitida
PUT	/users/	Criar usuário autorizado
POST	/users/:organizationId/:userId	Atualizar usuário autorizado
POST	/users/:organizationId/:userId/delete	Remover usuário autorizado
POST	/users/:organizationId/:userId/resend-invite	Reenviar convite de cliente provisório
POST	/users/:organizationId/:userId/revoke-invite	Revogar convite provisório
POST	/users/:organizationId/:userId/reset-password	Redefinir senha provisória permitida
POST	/organizations/me/logo	Enviar logo
DELETE	/organizations/me/logo	Remover logo
GET	/organizations/me/integrations/	Listar integrações
POST	/organizations/me/integrations/	Criar integração
GET	/organizations/me/integrations/:integrationId	Consultar integração
PATCH	/organizations/me/integrations/:integrationId	Atualizar integração
DELETE	/organizations/me/integrations/:integrationId	Remover integração
POST	/organizations/me/integrations/:integrationId/test	Testar integração

Consulte sua identidade

Use /users/me e /organizations/me para identificar usuário, organização e permissões. O gerenciamento de um cliente vale para a própria organização. Vínculos de provedor só permitem operações autorizadas para os clientes relacionados.

Provisionar um cliente

Um provedor com permissão de criação envia a POST /organizations/clients:

{
  "name":"Example Client",
  "shortname":"example-client",
  "initial_user":{
    "email":"[email protected]",
    "firstname":"Example",
    "lastname":"Manager",
    "mode":"invite"
  }
}

O modo de convite envia um link para definir a senha. A organização fica provisória até ser reivindicada. Convites e exclusão pelo provedor dependem desse estado. Após aceitação, a exclusão segue solicitação do cliente e revisão da plataforma.

Usuários

Criação e gestão exigem a permissão User correspondente e acesso à organização. Redefinição, revogação e reenvio pelo provedor atendem contas provisórias elegíveis, sem controle permanente sobre credenciais de clientes já reivindicados.

A função regular de gerenciamento é manager. administrator global é reservado à equipe Hashiro, não a provedores ou clientes.

Integrações

As rotas são da própria organização e exigem permissões e licença compatíveis. Credenciais são dados de entrada; não espere receber segredos em consultas posteriores. Consulte Jira para mapeamento e sincronização.