EndpointsCogents

Say something to the coach

POST/v2/cogents/{cogent_id}/say

Appends a line from the cogent to its chat log, or with to to that visitor's conversation (visitors/<user_id>), stamped now. Only the cogent's player may say.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token issued by Softmax

In: header

Path Parameters

cogent_id*Cogent Id

Cogent ID (its player ID).

Match^ply_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Request Body

application/json

text*Text

What the cogent says to its coach.

Length1 <= length <= 20000
aside?|

A quieter note beside the line.

goal_id?|

The task the line is about.

suggest?array<string>|

Replies to offer the coach.

stage?|

A stage view to show with the line, in the view shape of stage records.

to?|

A visitor's user id: the line answers into their conversation (visitors/<user_id>) instead of the coach's chat.

session_id?|

Owner-created chat identity; null is the original chat.

idempotency_key*Idempotency Key

Caller-chosen key for this write, unique within the caller's credential. A retry with the same key and the same write returns the original result; the same key with another write is refused. Keys starting with permit: are the server's.

Length1 <= length <= 200
curl -X POST "https://softmax.com/api/observatory/v2/cogents/string/say" \  -H "Content-Type: application/json" \  -d '{    "text": "string",    "idempotency_key": "string"  }'
{  "seq": 0}