EndpointsCogents

Get cogent presence

GET/v2/cogents/{cogent_id}/presence

Returns where the coach is looking, which agents are here, and which visitors have written. The coach fades after 90 s without a report and an agent after 120 s; the 32 visitors who wrote last are shown. With after and wait, the answer is held open until the version differs from after or wait seconds pass (at most 25).

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}$

Query Parameters

after?|

The version already seen; wait for a different one.

wait?Wait

Seconds to wait for a new version after after.

Range0 <= value <= 25
Default0
curl -X GET "https://softmax.com/api/observatory/v2/cogents/string/presence"
{  "version": 0,  "coach": {    "path": "string",    "anchor": "string",    "heading": "string",    "tab": "project",    "replay": {      "runId": "string",      "file": "string",      "tick": 0,      "open": true,      "shot": null,      "selection": null,      "camera": {        "x": 0,        "z": 0,        "distance": 0      }    },    "since": "2019-08-24T14:15:22Z",    "at": "2019-08-24T14:15:22Z"  },  "agents": [    {      "state": "idle",      "doing": "string",      "progress": {        "taskId": "string",        "rung": "string",        "done": 0,        "total": 0      },      "draft": "string",      "suggest": [        "string"      ],      "agent": "string",      "since": "2019-08-24T14:15:22Z",      "at": "2019-08-24T14:15:22Z"    }  ],  "visitors": [    {      "user_id": "string",      "name": "string",      "at": "2019-08-24T14:15:22Z"    }  ]}