AssistantsCreate an assistant

Create an assistant

Create a new assistant under an account. Dual authentication via withApiAuth (API key or session cookie).

curl -X POST "https://api.talkturo.com/api/assistants" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (tk_live_ or tk_test_)" \
  -d '{
  "accountSlug": "example_string",
  "name": "John Doe",
  "templateId": "example_string"
}'
{
  "success": true,
  "assistant": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "account_slug": "example_string",
    "name": "John Doe",
    "type": "example_string",
    "voice": "example_string",
    "model": "example_string",
    "created_at": "2024-12-25T10:00:00Z",
    "updated_at": "2024-12-25T10:00:00Z"
  }
}
POST
/assistants
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token (tk_live_ or tk_test_)
Bearer Tokenstring
Required

Talkturo API key. Send as Authorization: Bearer tk_live_... or Authorization: Bearer tk_test_.... Default scope is *; rate limit defaults to 1000 requests per hour.

Talkturo API key. Send as Authorization: Bearer tk_live_... or Authorization: Bearer tk_test_.... Default scope is *; rate limit defaults to 1000 requests per hour.
API Key (cookie: sb-access-token)
sb-access-tokenstring
Required

Authenticated Talkturo web session cookie (Supabase httpOnly session). Browser clients typically send this automatically after sign-in. Related refresh cookies may also be present depending on the client.

Authenticated Talkturo web session cookie (Supabase httpOnly session). Browser clients typically send this automatically after sign-in. Related refresh cookies may also be present depending on the client.
Content-Typestring
Required

The media type of the request body

Options: application/json
accountSlugstring
Required

Account slug that owns the assistant

namestring
Required

Assistant name

templateIdstring

Optional template; when present, sets assistant type from the template

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (tk_live_ or tk_test_). Talkturo API key. Send as Authorization: Bearer tk_live_... or Authorization: Bearer tk_test_.... Default scope is *; rate limit defaults to 1000 requests per hour.

path
parameterstring
Required

API Key for authentication. Authenticated Talkturo web session cookie (Supabase httpOnly session). Browser clients typically send this automatically after sign-in. Related refresh cookies may also be present depending on the client.

Body

application/json
accountSlugstring
Required

Account slug that owns the assistant

namestring
Required

Assistant name

templateIdstring

Optional template; when present, sets assistant type from the template

Responses

successboolean
assistantobject