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

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

string

required

User session token. Format: Bearer <user_session_token>.

string

required

Must be set to application/json

Request body

string

required

Human-readable name to identify the token (e.g., “CI Pipeline”, “Local Dev”). Max 255 characters.

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.

Get Started

Concepts

API Reference

Guides

Create User API Token

Create User API Token

Endpoint

Request headers

Request body

Examples

Response

Notes

​Create User API Token

​Endpoint

​Request headers

​Request body

​Examples

​Response

​Notes

Create User API Token

Endpoint

Request headers

Request body

Examples

Response

Notes