Skip to main content
PUT
/
v1
/
workspaces
/
{workspace_id}
/
skills
/
{skill_ref}
/
secrets
/
{key_name}
Set a skill secret
curl --request PUT \
  --url https://api.usezombie.com/v1/workspaces/{workspace_id}/skills/{skill_ref}/secrets/{key_name} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "value": "<string>",
  "scope": "host",
  "meta_json": "<string>"
}
'
{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": {}
  },
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

​
workspace_id
string<uuid>
required

Workspace identifier

​
skill_ref
string
required

Skill reference identifier

​
key_name
string
required

Secret key name

Body

application/json
​
value
string
required

Secret value — encrypted at rest, never echoed

​
scope
enum<string>

Where the secret is available. Defaults to both if omitted.

Available options:
host,
sandbox
​
meta_json
string

Optional JSON metadata for the secret (e.g. expiry, rotation info)

Response

Secret stored