Create Widget Session

post https://api.trinsic.id/api/v1/sessions/widget

Verify a user's identity using Trinsic's hosted Widget flow.

Responses

Response body

object

sessionId

uuid

required

The ID of the newly-created Acceptance Session

launchUrl

string

required

The URL that should be used to invoke the Acceptance Session on your user's device.

You can use our frontend SDKs to launch the user into the Acceptance Session, or you can redirect the user's browser to this URL.

This URL is sensitive and as such can only be obtained once. If you need to obtain it again, you will need to create a new Acceptance Session.

resultsAccessKey

string

required

The resultsAccessKey for the Acceptance Session.

This is an encrypted payload which contains the decryption key necessary to access the Session's Data Vault.

Save this securely in your systems; it must be passed back with any API call which requires access to the Session's Data Vault.

Trinsic cannot access a Session's Data Vault without this key.

401

Unauthorized

403

Forbidden

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.trinsic.id/api/v1/sessions/widget \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/*+json'


xxxxxxxxxx
 
1
{
2
  "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
3
  "launchUrl": "https://api.trinsic.id/api/session/launch?clientToken=...",
4
  "resultsAccessKey": "417zNGHMJp6Ht2jCoktTLNGDRZEt4BqTwwQ8Q9ZaQz8aS4Jd7nD1xff2WLhPS69j5q9QT4gvgV79Gv7QtaXwu5YC9Utr35..."
5
}

200OK

400Bad request

500Internal server error