POST /api/talk/stream

POST /api/talk/stream

Talk Stream

Authentication: Authorization: Bearer <key> or X-API-Key: <key>. Create keys at developers.cognitivx.io/keys.

Parameters

Name	In	Type	Required	Description
`X-Org-ID`	header	string \| null	No	-

Request body

A JSON request body is required.

Field	Type	Required	Description
`message`	string	Yes	-
`agent_slug`	string \| null	No	-
`current_task`	string \| null	No	-
`scope_mode`	string	No	Defaults to `"tiered"`.
`proposed_self_definition`	string \| null	No	-
`proposed_mandate`	string \| null	No	-
`proposed_boundaries`	string[] \| null	No	-
`proposed_agent_type`	string \| null	No	-

Example request

curl -X POST https://api.cognitivx.io/api/talk/stream \
  -H "Authorization: Bearer icog_..." \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Parsa prefers limit/offset pagination",
    "agent_slug": null,
    "current_task": null,
    "scope_mode": "tiered",
    "proposed_self_definition": null,
    "proposed_mandate": null,
    "proposed_boundaries": null,
    "proposed_agent_type": "semantic"
  }'

Example response

200 application/json

null

Responses

Status	Description
`200`	Success. Returns the response body shown below.
`422`	Request validation failed. `detail` lists each offending field.

Parameters

Request body

Example request

Example response

Responses

On this page