Gerar meu token de acesso
Gera um token pessoal e revoga o anterior na mesma transação — há exatamente um token ativo por usuário. O segredo aparece uma única vez, nesta resposta. O token vale o que o usuário vale agora e cai sozinho se ele for desativado, mudar de papel ou trocar a senha. O dono recebe um e-mail. Exige sessão: um token pessoal não se reemite. Aceita Idempotency-Key: a repetição com a mesma chave não gera um segundo token, mas também não devolve o segredo (ele nunca é guardado) — responde 409 IDEMPOTENCY_REPLAY_UNAVAILABLE e o token gerado aparece em GET /me/token.
Autorização
bearer session-onlyCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: session-only
Parâmetros de cabeçalho
Chave opcional de 1 a 255 caracteres ASCII visíveis; quando enviada, vale o mesmo contrato da §8.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/me/token" \ -H "Idempotency-Key: b3f0c1e2-4a5b-4c6d-8e9f-0a1b2c3d4e5f"{ "metadata": { "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "last_used_at": "2019-08-24T14:15:22Z", "last_used_ip": "string", "prefix": "string", "revoked_at": "2019-08-24T14:15:22Z", "revoked_reason": null, "status": "active" }, "token": "string"}