Get an organization secret

GET

/orgs/{org}/codespaces/secrets/{secret_name}

Gets an organization development environment secret without revealing its encrypted value.

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

API method documentation

Parameters

Path Parameters

org

required

string

The organization name. The name is not case sensitive.

secret_name

required

string

The name of the secret.

Responses

200

Response

Media type application/json

Codespaces Secret

Secrets for a GitHub Codespace.

object

name

required

The name of the secret

string

created_at

required

The date and time at which the secret was created, in ISO 8601 format’:’ YYYY-MM-DDTHH:MM:SSZ.

string format: date-time

updated_at

required

The date and time at which the secret was created, in ISO 8601 format’:’ YYYY-MM-DDTHH:MM:SSZ.

string format: date-time

visibility

required

The type of repositories in the organization that the secret is visible to

string

Allowed values: all private selected

selected_repositories_url

The API URL at which the list of repositories this secret is visible to can be retrieved

string format: uri

Examples

Example default

{
  "name": "GH_TOKEN",
  "created_at": "2019-08-10T14:59:22Z",
  "updated_at": "2020-01-10T14:59:22Z",
  "visibility": "all"
}

Headers

Link

string

Example

<https://api.github.com/resource?page=2>; rel="next", <https://api.github.com/resource?page=5>; rel="last"