Sign in
Research Agent

Send a message to a Research Agent session

Insert a follow-up message and start another asynchronous turn. Use messages to refine a result, answer the agent, redirect the research, or request another artifact.

The response includes a messageId. The corresponding user_message event carries the same value, allowing the client to confirm delivery.

Attach previously uploaded files by including their file_ids in the attachments array (see the Upload endpoint).

If the session is paused for insufficient quota, resolve the usage limit and resume it via POST /api/v2/sessions/:sessionId/resume (or the Elicit web interface) before sending another message.

Example

curl -X POST https://elicit.com/api/v2/sessions/agents/{sessionId}/messages \
  -H "Authorization: Bearer elk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"message":"Focus on randomized controlled trials only."}'
post/sessions/agents/{sessionId}/messages

Path parameters

sessionIdstring uuid required

Request body

messagestring required

The message to insert into the running research agent session.

Example request

{
  "message": "Focus on randomized controlled trials only.",
  "attachments": [
    {
      "file_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
    }
  ]
}

Response

Message accepted. The session is processing another turn.

sessionIdstring required

Unique identifier for the research agent session.

status'processing' required

The session is processing the inserted message.

messageIdstring required

Identifier of the inserted message. Correlate it with the messageId on the matching user_message event.

urlstring required

URL to view and continue the session in the Elicit web interface.

Changes

No recorded changes to this endpoint across all 1 revision of this API.