ONIOKODeveloper
Sessions

Read the registered state of a consented partner session.

In preparationNot released yet

This operation exists in the platform layer and is verified in CI, but it is not live for partners. The contract can still change before release. Do not build against it yet.

GET
/v1/sessions/{session_id}

The status describes the stored session record, not verified remote participant presence.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

session_id*Session Id
Formatuuid

Response Body

Successful response

application/json
  1. response
session_id*Session Id
Formatuuid
subject_id*Subject Id
Formatuuid
status*Status
Value in"starting""active"
created_at*Created At
Example Request
curl -X GET 'https://example.com/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
{  "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",  "subject_id": "80e197be-61ad-4068-b4ff-a483fb5c18f9",  "status": "starting",  "created_at": "string"}

Close a partner session and stop its remote avatar call. DELETE

The call stop is retried safely when the same idempotency key is used; an unconfirmed stop returns 503.

Start a session for a subject with active perception consent. POST

Contains pseudonymous personal data. A repeated start with the same key returns the original result; an uncertain start is never repeated automatically.