Retrieve the session

Describes the credential the request is made with: its kind (dashboard_session, cli_key, mcp_client or secret_key), the person it acts for, and the organizations and projects it can use.

Works with every credential.

Guide: Verify a credential

Errors

Status	`type`	`code`	When
401	`unauthenticated`	`session_ended`	When the connected app was disconnected or went unused too long.

It can also fail with the errors every operation shares, such as unauthenticated; see Errors.

Authorization

AuthorizationBearer <token>

A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.

In: header

Examples

curl -X GET "https://api.voidhash.com/api/v1/session" \  -H "Authorization: Bearer vh_sk_..."

{  "kind": "secret_key",  "person": null,  "connectedAppId": null,  "isReadOnly": false,  "organizations": [],  "projects": [    {      "id": "proj_tz4a98xxat96iws9zmbrgj3a",      "organizationId": "org_w5xk2e7q0lzv3n8b1c4d6f9g",      "name": "Acme Fitness",      "slug": "acme-fitness"    }  ]}

{  "error": {    "type": "invalid_request",    "code": "string",    "message": "string",    "param": "string"  }}

{  "error": {    "type": "unauthenticated",    "code": "session_ended",    "message": "This app was disconnected or went unused too long. Sign it in again."  }}

{  "error": {    "type": "internal",    "code": "internal_error",    "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing."  }}

Retrieve the session

Errors

More in Session

Retrieve the session

Errors

More in Session

Authorization

Examples

Response body

`application/json`

`application/json`

`application/json`

`application/json`

Retrieve the session

Errors

More in Session

Retrieve the session

Errors

More in Session

Authorization

Examples

Response body

200application/json

400application/json

401application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`