> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinsayless.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Messages API

> List conversation messages and send, edit, or delete messages.

## Auth

Bearer `sl_api_…` / `sl_oat_…`.

## List

```bash theme={"system"}
curl -X POST "$SAYLESS_API_URL/api/v1/messages/list_conversation_messages" \
  -H "Authorization: Bearer $SAYLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"workspaceId\":\"$SAYLESS_WORKSPACE_ID\",\"_id\":\"$CONVERSATION_ID\",\"limit\":50}"
```

## Send

Honor `Idempotency-Key` on retries.

```ts theme={"system"}
await sayless.messages.sendMessage({
  workspaceId,
  conversationId,
  messageId: crypto.randomUUID(),
  channel: 'email',
  content: '…',
  preview: '…',
});
```

Also: `edit_message`, `delete_message`, reaction add/remove.

Related: [Conversations](/developers/api/conversations) · [SDK examples](/developers/sdk/examples)