Pular para o conteúdo principal
POST
/
api
/
v1
/
user
/
api-tokens
curl -X POST "https://app.talkover.ai/api/v1/user/api-tokens" \
  -H "Authorization: Bearer your_user_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CI Pipeline",
    "abilities": ["*"]
  }'

{
  "data": {
    "id": "token-uuid-1",
    "name": "CI Pipeline",
    "abilities": ["*"],
    "token": "1|abc123def456.",
    "created_at": "2024-01-15T19:00:00Z"
  }
}

​
Criar Token de API do Usuário

Cria um novo Personal Access Token (PAT) para o usuário atual. O valor completo do token é retornado apenas uma vez na resposta — armazene-o com segurança.
Este endpoint faz parte da API de Conta e é autenticado com um token de sessão de usuário.

​
Endpoint

POST /api/v1/user/api-tokens

​
Cabeçalhos da requisição

​
Authorization
string
obrigatório
Token de sessão do usuário. Formato: Bearer <user_session_token>.
​
Content-Type
string
obrigatório
Deve ser definido como application/json

​
Corpo da requisição

​
name
string
obrigatório
Nome legível para identificar o token (ex: “CI Pipeline”, “Local Dev”). Máximo de 255 caracteres.
​
abilities
array
Lista opcional de habilidades a conceder. Use ["*"] para acesso total. Se omitido, acesso total é concedido.

​
Exemplos

curl -X POST "https://app.talkover.ai/api/v1/user/api-tokens" \
  -H "Authorization: Bearer your_user_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CI Pipeline",
    "abilities": ["*"]
  }'

​
Resposta

{
  "data": {
    "id": "token-uuid-1",
    "name": "CI Pipeline",
    "abilities": ["*"],
    "token": "1|abc123def456.",
    "created_at": "2024-01-15T19:00:00Z"
  }
}
O campo token é retornado apenas uma vez. Armazene-o imediatamente — ele não pode ser recuperado depois. Se for perdido, revogue o token e crie um novo.

​
Observações

  • Use o token como Authorization: Bearer <token> em requisições subsequentes.
  • Para automação com escopo de ambiente (agentes, chamadas, campanhas), utilize tokens de ambiente (talq_*).