Home
API reference
Platform API reference
Platform API
OAuth API keys
Get OAuth API keys

Get OAuth API keys

get/v1/environments/{environmentId}/apikeys
Page View

OAuth API key endpoints allow you to view and manage OAuth API keys for a given environment in your Redox organization. Learn more about OAuth API keys, which is our preferred authentication method.

You can retrieve, create, update, or delete OAuth API keys.

Get OAuth API keys

Retrieve a list of any OAuth API keys that have already been configured for the specified environment in your Redox organization.

Request parameters

cURL request example

bash
1
curl 'https://api.redoxengine.com/platform/v1/environments/{environmentId}/apikeys' \
2
--request GET \
3
--header 'Authorization: Bearer $API_TOKEN' \
4
--header 'accept: application/json'

Path Parameters

  • environmentId
    required, string

    Identifies the specific environment that you're operating in or on behalf of.

Response fields and example

Example payload generated from schema
1
{
2
  "meta": {
3
    "version": "1.0.0"
4
  },
5
  "payload": {
6
    "apikeys": [
7
      {
8
        "name": "string",
9
        "jwksURL": "string",
10
        "jwkSet": {
11
          "keys": [
12
            {
13
              "kid": "string",
14
              "kty": "string"
15
            }
16
          ]
17
        },
18
        "id": "string",
19
        "environment": {
20
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
21
          "environmentFlag": "Staging"
22
        }
23
      }
24
    ]
25
  }
26
}
  • meta
    object
    • version
      string

      Lists the major and minor version number for the format of the returned payload. The payload format or shape may change between minor versions, like including additional or extended fields in later versions. We include the version data in each response so that you have the option to handle the signaled differences.

  • payload
    object

    Contains the payload with details about the requested OAuth API key(s).

    • apikeys
      Array of object

      Contains an array of OAuth API Keys.

      • name
        string

        Displays the human-readable name of the OAuth API key.

      • jwksURL
        string

        Contains the JWKS URL for the OAuth API key.

      • jwkSet
        object

        Contains a JSON Web Key Set (JWKS). See the JWK Set Format spec for more details.

        • keys
          Array of object

          Contains an array of JWK objects. Each JWK must have a kid and kty, along with some other properties depending on the key type. See the JWK spec for more details.

          • kid
            required, string

            Displays the JWK ID ("Key ID").

          • kty
            required, string

            Identifies the JWK type ("Key type").

      • id
        string

        Displays the unique identifier (i.e., client ID) of the OAuth API key.

      • environment
        object

        Contains metadata about the environment within the associated Redox organization.

        • id
          string

          Contains the unique identifier of the Redox environment.

          Format: uuid
        • environmentFlag
          string

          Indicates whether the environment is used for development, staging, or production.

          Possible Values: Production, Staging, Development