Assistants API

Base URL: https://app.lisn.dev/api

Create and manage AI assistants. Each assistant has a type (voice or text), an LLM configuration, and optionally an STT configuration (voice only).

Endpoints

Method	Endpoint	Description
`GET`	`/api/v1/assistants`	List all assistants
`POST`	`/api/v1/assistants`	Create assistant
`GET`	`/api/v1/assistants/{id}`	Get assistant
`PATCH`	`/api/v1/assistants/{id}`	Update assistant
`DELETE`	`/api/v1/assistants/{id}`	Delete assistant
`POST`	`/api/v1/assistants/{id}/duplicate`	Duplicate assistant

Create Assistant

`POST /api/v1/assistants`

Parameters:

Field	Type	Required	Description
`name`	string	Yes	Assistant name
`type`	string	Yes	`"voice"` or `"text"`
`description`	string	No	Optional description
`stt_provider`	string	No	STT provider (voice only): `elevenlabs`, `whisper`, `aisha`
`stt_model`	string	No	STT model ID
`stt_language`	string	No	Language code or `"Auto-Detect"`
`llm_provider`	string	Yes	LLM provider: `openai`, `anthropic`, `gemini`, `grok`
`llm_model`	string	No	LLM model ID
`system_prompt`	string	Yes	Analysis instructions for the LLM
`temperature`	float	No	0.0 – 1.0 (default: 0.7)
`webhook_url`	string	No	URL to receive results
`webhook_secret`	string	No	Bearer token for webhook auth

Example:

curl -X POST "https://app.lisn.dev/api/v1/assistants" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Analyzer",
    "type": "voice",
    "stt_provider": "elevenlabs",
    "stt_language": "Auto-Detect",
    "llm_provider": "openai",
    "llm_model": "gpt-4o-mini",
    "system_prompt": "Analyze this call transcript...",
    "temperature": 0.7,
    "webhook_url": "https://your-server.com/webhook"
  }'

List Assistants

`GET /api/v1/assistants`

curl "https://app.lisn.dev/api/v1/assistants" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Get Assistant

`GET /api/v1/assistants/{id}`

curl "https://app.lisn.dev/api/v1/assistants/ast_abc123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Update Assistant

`PATCH /api/v1/assistants/{id}`

curl -X PATCH "https://app.lisn.dev/api/v1/assistants/ast_abc123" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Updated Analyzer Name"}'

Delete Assistant

`DELETE /api/v1/assistants/{id}`

curl -X DELETE "https://app.lisn.dev/api/v1/assistants/ast_abc123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Duplicate Assistant

`POST /api/v1/assistants/{id}/duplicate`

curl -X POST "https://app.lisn.dev/api/v1/assistants/ast_abc123/duplicate" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Authentication Voice Analysis