Update a variable for a workspace

Add or change a variable's row, as for secrets.

PATCH/workspaces/{workspace}/actions/variables/{setting}

Authentication: Required. Send an access token as Authorization: Bearer.
MCP tool: set_actions_variable, with the same inputs
Also at: POST /repos/{owner}/{name}/actions/variables, PATCH /repos/{owner}/{name}/actions/variables/{setting}, POST /workspaces/{workspace}/actions/variables

Path parameters

Name	Type	Required	Description
`workspace`	string	Yes	Instead of repo: the workspace, for the ones every repository in it reads.
`setting`	string	Yes	The key, such as NPM_TOKEN.

Body parameters

Send a JSON object. Names are snake_case, as in responses; the camelCase spelling is accepted too.

Name	Type	Required	Description
`value`	string	No	Needed for a new row; left out, the row keeps its value.
`id`	string	No	The row to change, from a list. Left out: the key’s row for every environment.
`available_to`	array of strings	No	Who reads it. Both for a new row. One of `workflows`, `deployments`.
`environments`	array of strings	No	The environments it applies to, such as production and preview, or a workflow job’s environment. Empty is every environment.
`projects`	array of strings	No	A workspace’s row: the projects it reaches, by slug. Empty is every one.
`note`	string	No	Where to rotate it, or who to ask.

Example request

curl -X PATCH https://api.g1t.sh/workspaces/flagon-io/actions/variables/NODE_VERSION \
  -H "Authorization: Bearer $G1T_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "22"
  }'

Example response

A successful request answers 200 with:

{
  "id": "set_01kpv9q4r7s0t3v6w9x2y5z8ad",
  "name": "NODE_VERSION",
  "kind": "variable",
  "value": "22",
  "scope": "workspace",
  "updated_at": "2026-10-04T15:42:07.318Z",
  "available_to": [
    "workflows",
    "deployments"
  ],
  "environments": [],
  "projects": [],
  "note": null,
  "updated_by": "syntaqx"
}

Errors

A failed request answers with one of these statuses and a body like {"error": {"code": "not_found", "message": "Repository not found."}}. See errors.

Status	Code	When
401	`unauthenticated`	A token is required, or the one sent is not valid.
403	`forbidden`	The token is valid but not allowed to do this, such as a member-only change or an agent token outside its repository.
404	`not_found`	It does not exist, or you cannot see it.
409	`conflict`	The request conflicts with the current state.
422	`invalid`	The input is not valid. `message` says which field and why.