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"
}
}
Account API
Create User API Token
Create a new personal access token (PAT) for the current user
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
string
required
User session token. Format:
Bearer <user_session_token>.string
required
Must be set to
application/jsonRequest 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.
Was this page helpful?