Start an async agent interaction with a callback URL. | Scout

Dedicated handler for async agent interactions exposed via the SDK.

Requires callback_url and always returns 202 with session_id + events_url.

AuthorizationBearer

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

agent_idstringRequired

session_idstring or nullOptionalformat: "uuid"

This endpoint expects an object.

messageslist of objectsRequired

List of incoming user messages and drive file references.

callback_urlstringRequired

Callback URL that Scout will POST to when the interaction completes. The request is signed with HMAC-SHA256 using the organization’s secret key.

metadatamap from strings to anyOptional

Optional metadata (e.g., salesforce_session)

Successful Response

session_idstring

The session ID for the interaction.

events_urlstring

URL to replay the interaction's event stream.

1	curl -X POST https://api.scoutos.com/world/agent_id/_interact_async \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"messages": [
6	{
7	"content": "Hello, can you provide the latest update on the project status?"
8	}
9	],
10	"callback_url": "https://clientapp.example.com/api/callbacks/agent_response"
11	}'

1	{
2	"session_id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3	"events_url": "https://api.example.com/world/agent_id/events/a1b2c3d4-e5f6-7890-ab12-cd34ef567890"
4	}