Authentication

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

All API requests require authentication via a Bearer token in the Authorization header. You can generate API tokens from the Settings → API Tokens page.

Authorization: Bearer YOUR_API_TOKEN

Endpoints

Method	Endpoint	Description
`POST`	`/api/v1/auth/register`	Register new account
`POST`	`/api/v1/auth/login`	Login & get token
`GET`	`/api/user/me`	Get current user
`PATCH`	`/api/user/me`	Update profile
`POST`	`/api/v1/auth/change-password`	Change password

Register

`POST /api/v1/auth/register`

curl -X POST "https://app.lisn.dev/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password",
    "name": "Your Name"
  }'

Login

`POST /api/v1/auth/login`

curl -X POST "https://app.lisn.dev/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'

Get Current User

`GET /api/user/me`

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

Update Profile

`PATCH /api/user/me`

curl -X PATCH "https://app.lisn.dev/api/user/me" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "New Name"}'

Change Password

`POST /api/v1/auth/change-password`

curl -X POST "https://app.lisn.dev/api/v1/auth/change-password" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "current_password": "old-password",
    "new_password": "new-secure-password"
  }'

Token Management

Method	Endpoint	Description
`GET`	`/api/v1/keys`	List API tokens
`POST`	`/api/v1/keys`	Create API token
`DELETE`	`/api/v1/keys/{key_id}`	Revoke API token

Create API Token

curl -X POST "https://app.lisn.dev/api/v1/keys" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Integration Key"}'

⚠️

Store your API token securely. The full token value is only shown once at creation time. If you lose it, you will need to generate a new one.

List API Tokens

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

Revoke API Token

curl -X DELETE "https://app.lisn.dev/api/v1/keys/{key_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Assistants API