Skip to main content
POST
Compose Modus context

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Body

application/json
message
string
required

User message or intent used to compose relevant context.

Minimum string length: 1
Example:

"What tables describe customer churn?"

limit
number

Optional cap on context items in structured JSON fallback.

Required range: 1 <= x <= 200
Example:

25

Response

context
string
required

Composed context for the intent (markdown or JSON fallback).

contextItems
object[]
required
deprecated

Deprecated. Always an empty array. Use context for composed text (markdown or JSON fallback).

Example:
originalCount
number
required

Total context items in the configured scope (before composition strategies).

selectedCount
number
required

Context items the composer kept for this intent.

sessionId
string
required

Session id used for this composition.