API tokens¶

Um token de acesso pessoal permite que um script, um job de CI ou qualquer integração chame a API REST do Empi como você. Ele vê exatamente o que você vê e pode alterar exatamente o que você pode alterar.

Criar um token¶

Abra Settings > API.
Clique em Create token.
Dê a ele um Name (por exemplo, "CI pipeline") para reconhecê-lo depois.
Escolha suas Permissions: Read-only (apenas requisições GET) ou Read & write (ler e modificar dados).
Escolha uma Expiration: 7 dias, 30 dias, 90 dias, 1 ano ou sem expiração.
Clique em Create e então copie o segredo.

Warning

O segredo é exibido uma única vez, na criação. Ele concede acesso a todo o seu workspace, então guarde-o como uma senha (um gerenciador de segredos, o cofre de segredos da sua CI) e nunca o cole em um documento compartilhado ou em um repositório público. Se um token vazar, revogue-o imediatamente: a revogação tem efeito instantâneo.

Cada linha de token mostra quando ele expira e quando foi usado pela última vez, para que você possa identificar um que esqueceu.

Usar um token¶

Envie-o como um bearer token nas suas requisições de API. A lista completa de endpoints, seus parâmetros e suas respostas fica na API reference.

Revogar um token¶

Clique em Revoke na linha do token e confirme. O token para de funcionar imediatamente e não pode ser restaurado. Crie um novo se ainda precisar de acesso.

Chamadas feitas com um token são atribuídas à API no seu activity log.

Tip

Se o seu objetivo é permitir que um assistente de IA trabalhe com suas tarefas, você não precisa de um token de forma alguma. Use o MCP server em vez disso: ele entra pelo seu navegador e você pode desconectá-lo a qualquer momento.