Skip to main content
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"
  }
}

​
Create User API Token

Create a new personal access token (PAT) for the current user. The full token value is returned only once in the response — store it securely.
This endpoint is part of the Account API and is authenticated with a user session token.

​
Endpoint

POST /api/v1/user/api-tokens

​
Request headers

​
Authorization
string
required
User session token. Format: Bearer <user_session_token>.
​
Content-Type
string
required
Must be set to application/json

​
Request body

​
name
string
required
Human-readable name to identify the token (e.g., “CI Pipeline”, “Local Dev”). Max 255 characters.
​
abilities
array
Optional list of abilities to grant. Use ["*"] for full access. If omitted, full access is granted.

​
Examples

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": ["*"]
  }'

​
Response

{
  "data": {
    "id": "token-uuid-1",
    "name": "CI Pipeline",
    "abilities": ["*"],
    "token": "1|abc123def456.",
    "created_at": "2024-01-15T19:00:00Z"
  }
}
The token field is returned only once. Store it immediately — it cannot be retrieved later. If lost, revoke the token and create a new one.

​
Notes

  • Use the token as Authorization: Bearer <token> in subsequent requests.
  • For environment-scoped automation (agents, calls, campaigns), use environment tokens (talq_*) instead.