auth::tokens

Returns the namespace, subject, grants and lifetime of the JWT that authenticates the request.

Changed on
get/auth/tokens/inspect

Request

  • Base URL
    https://api.rivet.dev
  • URL
    https://api.rivet.dev/auth/tokens/inspect
  • Auth
    • HTTP bearer
    • or API key in header x-rivet-token

Response

The token's claims. The response carries Cache-Control: no-store.

namespacestring required

Name of the namespace the token is scoped to.

subjectstring nullable required

Subject attached to the token, or null.

issued_tsinteger required

When the token was issued, in Unix milliseconds.

expires_tsinteger required

When the token expires, in Unix milliseconds.

Example response

{
  "grants": [
    {
      "target": {
        "id": "d97pbq1nyqxw1w5qdwz0iirbqiblh2"
      }
    }
  ]
}

Changes

    • breaking

      removed the required property from the response with the status

    • warning

      added the new node enum value to the // response property for the response status

    • warning

      added the new pool enum value to the // response property for the response status

    • info

      the endpoint scheme security rivet_token_header was added to the API

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      the response property became required for the status

    • info

      removed the runner enum value from the // response property for the response status

    • info

      removed the runner_config enum value from the // response property for the response status

    • info

      added the required property to the response with the status

    • info

      endpoint added