Send messages to an agent within a session and receive a streaming response. | Scout

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

agent_idstringRequired

session_idstring or nullRequiredformat: "uuid"

This endpoint expects an object.

messageslist of objectsRequired

List of incoming user messages and drive file references.

metadatamap from strings to anyOptional

Optional metadata (e.g., salesforce_session)

callback_urlstring or nullOptional

Optional callback URL. If provided, the interaction runs asynchronously and the response returns 202 with session_id + events_url.

Successful Response

1	curl -X POST https://api.scoutos.com/world/agent_id/string/_interact \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"messages": [
6	{
7	"content": {
8	"text": "Hello, can you provide the current status of the mission?"
9	}
10	}
11	]
12	}'