canonical

Open an evidence session

Start an enroll or observe session for a subject using the scoped browser workflow.

post/api/v1/sessions

Request

Base URL
https://app.graypass.org (the document declares no server; this is the origin it was published from)
URL
https://app.graypass.org/api/v1/sessions
Auth
HTTP bearer

Request body

device_contextobject nullable

Optional customer-provided device context, without independent device integrity attestation. Apply your endpoint controls to establish device trust.

purpose'observe' | 'enroll'

enroll collects enrollment evidence; observe assesses continuity. The default is observe.

subjectstring required

Pseudonymous subject identifier in the authenticated tenant and environment.

Response

Session id, purpose, feature version, scoped signing material and research eligibility flag.

created_atstring required

Creation time as an ISO 8601 timestamp.

feature_schema_versionstring required

Version identifier for the feature representation used by the session or assessment.

frame_signing_algstring nullable

Algorithm identifier for the session’s evidence-signing material.

frame_signing_keystring nullable

Session-specific signing secret for SDK evidence transport, when issued. Never log or expose it to another subject.

idstring required

Identifier of this record. Treat it as opaque and retain it for subsequent operations.

purposestring required

Session purpose, enroll or observe.

research_enabledboolean

Environment participation and a current subject consent receipt are both present at session creation. Storage also requires deployment enablement, current consent and per-frame opt-in.