GET/auth/context

Get auth context

Requires Bearer authentication. See Authentication.

Responses

200 200

Field Type Description

authMethodrequired enum (4) —

principalrequired AuthContextPrincipal —

type = user

`type`required	"user"	—
`id`required	string (uuid)	—
`email`required	string	—
`name`required	string	—

type = api-key

`type`required	"api-key"	—
`id`required	string	—
`name`required	string	—

type = mcp-api-key

`type`required	"mcp-api-key"	—
`id`required	string	—
`name`required	string	—

tenantrequired object —

`id`required	string (uuid)	—
`name`required	string	—

environmentrequired "PRODUCTION" | "STAGING" | "DEVELOPMENT" —

environmentMode "fixed" | "per-call" —

availableEnvironments "PRODUCTION" | "STAGING" | "DEVELOPMENT"[] —

scopesrequired string[] —

permissionsrequired string[] —

401 401

Field Type Description

errorrequired object —

`code`required	string	—
`message`required	string	—
`details`	any	—

Errors

Errors use the standard envelope. See Errors for codes, status mappings, and retry semantics.

Request

curl -X GET https://api.pushrail.io/auth/context \
  -H "Authorization: Bearer pk_live_..." \

Response · 200200

{
  "authMethod": "session",
  "principal": {
    "type": "user",
    "id": "00000000-0000-0000-0000-000000000000",
    "email": "string",
    "name": "string"
  },
  "tenant": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string"
  },
  "environment": "PRODUCTION",
  "environmentMode": "fixed",
  "availableEnvironments": [],
  "scopes": [
    "string"
  ],
  "permissions": [
    "string"
  ]
}

Response · 401401

{
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}