Set one Doppler secret

Create or update a single secret. Runtime probes existence then POSTs a change_request. Returns acknowledgment only; config-wide secret-map responses are discarded unread.

Agent markdown

secrets.set · Doppler · v1

Details

Risk: Write
Idempotency: Unsafe
Availability: Default
Exposure: REST, SDK
MCP hints: readOnly=false, destructive=false, idempotent=false, openWorld=true

Scopes

None

Input

Input schema
Name	Type	Required	Constraints
`(root)`	`object`	Yes	additionalProperties false
`project`	`string`	Yes	minLength 1; maxLength 128; pattern ^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$
`config`	`string`	Yes	minLength 1; maxLength 60; pattern ^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$
`name`	`string`	Yes	minLength 1; maxLength 200; pattern ^[A-Z_][A-Z0-9_]{0,199}$
`value`	`string`	Yes	minLength 1; maxLength 51200
`visibility`	`string`	Yes	enum masked \| unmasked \| restricted

Output

Output schema
Name	Type	Required	Constraints
`(root)`	`object`	Yes	additionalProperties false
`project`	`string`	Yes	minLength 1; maxLength 128; pattern ^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$
`config`	`string`	Yes	minLength 1; maxLength 60; pattern ^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$
`name`	`string`	Yes	minLength 1; maxLength 200; pattern ^[A-Z_][A-Z0-9_]{0,199}$
`saved`	`boolean`	Yes	—

Raw schema

Input

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "project": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$"
    },
    "config": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "pattern": "^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[A-Z_][A-Z0-9_]{0,199}$"
    },
    "value": {
      "type": "string",
      "minLength": 1,
      "maxLength": 51200
    },
    "visibility": {
      "type": "string",
      "enum": [
        "masked",
        "unmasked",
        "restricted"
      ]
    }
  },
  "required": [
    "project",
    "config",
    "name",
    "value",
    "visibility"
  ]
}

Output

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "project": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$"
    },
    "config": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "pattern": "^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[A-Z_][A-Z0-9_]{0,199}$"
    },
    "saved": {
      "type": "boolean"
    }
  },
  "required": [
    "project",
    "config",
    "name",
    "saved"
  ]
}

Set one Doppler secret

Details

Scopes

Input

Output

Raw schema

On this page