Get the customization template for an OIDC subject claim for an organization

GET

/orgs/{org}/actions/oidc/customization/sub

Gets the customization template for an OpenID Connect (OIDC) subject claim.

OAuth app tokens and personal access tokens (classic) need the read:org scope to use this endpoint.

API method documentation

Parameters

Path Parameters

org

required

string

The organization name. The name is not case sensitive.

Responses

200

A JSON serialized template for OIDC subject claim customization

Media type application/json

Actions OIDC Subject customization

Actions OIDC Subject customization

object

include_claim_keys

required

Array of unique strings. Each claim key can only contain alphanumeric characters and underscores.

Array<string>

use_immutable_subject

Whether to opt in to the immutable OIDC subject claim format for the organization. When true, new OIDC tokens will use a stable, repository-ID-based sub claim instead of the name-based format.

boolean

Examples

Example default

{
  "include_claim_keys": [
    "repo",
    "context"
  ]
}