Send a chat message

POST/v1/monitors/{monitor_id}/agent/chat

Send your API key as Authorization: Bearer. See Authentication. How each option works: Monitors.

Path parameter

monitor_idstring

The ID of a monitor that has an agent.

Request body

messagestringat most 4000 characters

Your question, or the change to make.

panel_idstring

Ask about this panel. See List panels.

Response

202The agent answers in a job. Read the answer with List chat messages.

job_idstring

The ID of the job that answers. See Get a job.

message_idstring

The ID of your message.

Errors

Status	Code	When
400	invalid_request	The message is blank.
401	unauthorized	The API key is missing or not valid.
403	forbidden	The API key cannot read monitors (a GET) or change them (the other methods).
404	not_found	The monitor, its agent or the panel is not in your key's project.
409	monitor_ended	The monitor has ended. What the agent found stays readable, but nothing can change.
409	budget_exhausted	Today's budget for this monitor is spent. It resets at midnight UTC.
409	job_in_progress	The agent is still working on the last request. Try again when it finishes.
422	invalid_request	A parameter or the body is not valid. error.param names it.
429	rate_limited	Your key or account sent too many requests. Wait for the seconds in Retry-After, then try again.

What each error means and what to do: Errors.

Request

cURL

curl -X POST "https://router.telem.ai/v1/monitors/$MONITOR_ID/agent/chat" \
  -H "Authorization: Bearer $TELEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Which companies raised money this week?"}'

Response

202

{
  "job_id": "3c8d2a71-5e04-4b9f-a6d3-7f1e2b9c4d05",
  "message_id": "9a4f6b2e-1d7c-4e83-b5a0-6c2d8e1f3a97"
}

An example built from the response schema.