Mojo UpDocs
API reference

Live sessions

My live sessions

GET/people/v1/me/live

The signed-in person's own sessions on every machine, newest report first, each with the machine, whether it is online, and canControl (always true here). Taken from the list each machine reported on its heartbeat (AIOE 0.43.0). The live detail and every action go over the relay.

Authorization

cloudSession
AuthorizationBearer <token>

Mojo Up AI Cloud: a person's access token from /auth/v1/token. Name the organisation with the X-Aioe-Organisation header where a request acts for one.

In: header

Header Parameters

X-Aioe-Organisation?string

Mojo Up AI Cloud only, with a person's access token: the id of the organisation the request is for. A person's session is not tied to one organisation, so each request names it. Device tokens already carry their organisation.

Response Body

application/json

application/json

curl -X GET "https://example.com/people/v1/me/live"
{  "sessions": [    {      "deviceId": "string",      "deviceName": "string",      "online": true,      "lastSeenAt": "2019-08-24T14:15:22Z",      "session": {},      "projectId": "string",      "projectName": "string",      "canControl": true    }  ]}

A project's live sessions

GET/projects/v1/{id}/live

The project's sessions the caller may watch (AIOE 0.43.0): their own, any Team Work, and conversations shared with the project or with them. canControl is true only for the caller's own sessions; everyone else may only watch.

Authorization

AuthorizationBearer <token>

A device access token from the device-code flow (aioe_at_…). A DPoP-bound token is sent as Authorization: DPoP <token> with a fresh DPoP proof on every request.

In: header

Path Parameters

id*string

The project.

Header Parameters

X-Aioe-Organisation?string

Mojo Up AI Cloud only, with a person's access token: the id of the organisation the request is for. A person's session is not tied to one organisation, so each request names it. Device tokens already carry their organisation.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/projects/v1/string/live"
{  "sessions": [    {      "deviceId": "string",      "deviceName": "string",      "online": true,      "lastSeenAt": "2019-08-24T14:15:22Z",      "session": {},      "projectId": "string",      "projectName": "string",      "canControl": true    }  ]}