Search + K

Command Palette

Search for a command to run...

Sign In

Create or update an organization secret

PUT /orgs/{org}/actions/secrets/{secret_name}
Copy endpoint
https://api.github.com

Creates or updates an organization secret with an encrypted value. Encrypt your secret using LibSodium. For more information, see "Encrypting secrets for the REST API."

Authenticated users must have collaborator access to a repository to create, update, or read secrets.

OAuth tokens and personal access tokens (classic) need theadmin: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.

Parameters

path Path Parameters

Name Type
org required

The organization name. The name is not case sensitive.

string
secret_name required

The name of the secret.

string

Request Body

application/json required
{
encrypted_value: string;
key_id: string;
visibility: "all" | "private" | "selected";
selected_repository_ids?: number[];
}

Responses

201 application/json

Response when creating a secret

interface EmptyObject {}
204

Response when updating a secret

unknown