Send messages to an agent within a session and receive a synchronous 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

1	curl -X POST https://api.scoutos.com/world/agent_id/string/_interact_sync \
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 weather update for New York City?"
9	}
10	}
11	]
12	}'