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"
  }
}

POST

api

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

string

obrigatório

Token de sessão do usuário. Formato: Bearer <user_session_token>.

string

obrigatório

Deve ser definido como application/json

Corpo da requisição

string

obrigatório

Nome legível para identificar o token (ex: “CI Pipeline”, “Local Dev”). Máximo de 255 caracteres.

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_*).

Primeiros Passos

Conceitos

Referência da API

Guias

Criar Token de API do Usuário

Criar Token de API do Usuário

Endpoint

Cabeçalhos da requisição

Corpo da requisição

Exemplos

Resposta

Observações

​Criar Token de API do Usuário

​Endpoint

​Cabeçalhos da requisição

​Corpo da requisição

​Exemplos

​Resposta

​Observações

Criar Token de API do Usuário

Endpoint

Cabeçalhos da requisição

Corpo da requisição

Exemplos

Resposta

Observações