Skip to content

Get an organization secret

GET
/orgs/{org}/agents/secrets/{secret_name}

Gets a single organization secret without revealing its encrypted value.

The authenticated user must have collaborator access to a repository to create, update, or read secrets.

OAuth tokens and personal access tokens (classic) need the admin:org scope to use this endpoint. If the repository is private, OAuth tokens and personal access tokens (classic) need the repo scope to use this endpoint.

API method documentation

org
required
string

The organization name. The name is not case sensitive.

secret_name
required
string

The name of the secret.

Response

Media type application/json
Actions Secret for an Organization

Secrets for GitHub Actions for an organization.

object
name
required

The name of the secret.

string
created_at
required
string format: date-time
updated_at
required
string format: date-time
visibility
required

Visibility of a secret

string
Allowed values: all private selected
selected_repositories_url
string format: uri
Examples
Example default
{
"name": "GH_TOKEN",
"created_at": "2019-08-10T14:59:22Z",
"updated_at": "2020-01-10T14:59:22Z",
"visibility": "selected",
"selected_repositories_url": "https://api.github.com/orgs/octo-org/actions/secrets/SUPER_SECRET/repositories"
}