Skip to main content
POST
https://api.usenotra.com
/
v1
/
chats
Start a new chat and stream the reply
curl --request POST \
  --url https://api.usenotra.com/v1/chats \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "enableThinking": true,
  "timezone": "<string>",
  "context": [
    {
      "type": "github-repo",
      "integrationId": "<string>",
      "owner": "<string>",
      "repo": "<string>"
    }
  ],
  "externalChannelId": {
    "id": "<string>"
  }
}
'
"<string>"

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY.

Body

application/json
message
string
required
Required string length: 1 - 50000
model
enum<string>
Available options:
auto,
anthropic/claude-opus-4.8,
anthropic/claude-sonnet-4.6,
anthropic/claude-haiku-4.5,
openai/gpt-5.4,
openai/gpt-5.5
enableThinking
boolean
thinkingLevel
enum<string>
Available options:
off,
low,
medium,
high
timezone
string
Required string length: 1 - 100
context
object[]
externalChannelId
object | null

Response

Streaming UI message stream (newline-delimited JSON chunks). Read the X-Chat-Id response header for the chat id, or take it from the start chunk's messageMetadata.chatId.

The response is of type string.

Last modified on July 6, 2026