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

Authentication

AuthorizationBearer

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

Path parameters

agent_idstringRequired

session_idstring or nullRequiredformat: "uuid"

Request

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.

revision_idstring or nullOptional

tagslist of strings or nullOptional

Optional tags for categorizing this interaction in observability history. Max 20 tags, each up to 32 lowercase alphanumeric characters plus ’:’, ’_’, ’-’.

Response

Successful Response

Errors

422

Unprocessable Entity Error

$	curl -X POST https://api.scoutos.com/world/agent_id/string/_interact \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"messages": [
>	{
>	"content": {
>	"text": "Hello, can you provide the current status of the mission?"
>	}
>	}
>	]
>	}'

$	curl -X POST https://api.scoutos.com/world/agent_id/string/_interact \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"messages": [
>	{
>	"content": {
>	"text": "Hello, can you provide the current status of the mission?"
>	}
>	}
>	]
>	}'