Substy Developers
Intelligence

Send intelligence message

Send a task or question to Substy Intelligence, optionally with mentions and attachments, and collect response events. The agent can propose platform actions for approval; broad category access is required. Ordinary AI processing charges may apply.

POST/v1/agencies/{agencyId}/intelligence/interactions

Send a task or question to Substy Intelligence, optionally with mentions and attachments, and collect response events. The agent can propose platform actions for approval; broad category access is required. Ordinary AI processing charges may apply.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agencies/string/intelligence/interactions" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "content": "string",    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"  }'
{  "data": {    "events": [      {        "type": "accepted",        "conversationId": "string",        "runId": "string",        "userMessageId": "string"      }    ]  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

Get intelligence mention details GET

Resolve up to 20 previously identified mention references into the contextual details used by Substy Intelligence.

Resume intelligence run POST

Approve or reject one pending Substy Intelligence action and collect the resumed run's events. Approving can execute the proposed platform action.