Creates a secret (POST /api/v4/secrets/{name}). Folders are not created automatically
(NotFoundError); an existing key raises ConflictError. The server trims the value.
Creates several secrets atomically (POST /api/v4/secrets/batch); order not guaranteed.
Deletes a secret (all versions, DELETE /api/v4/secrets/{name}); NotFoundError when missing.
Deletes several secrets atomically (DELETE /api/v4/secrets/batch).
Renders the secrets of a folder as a dotenv file (KEY="value" lines sorted by key).
Reads one secret (GET /api/v4/secrets/{name}); NotFoundError when missing.
Lists the secrets of a folder (GET /api/v4/secrets). References are expanded and imports
included by default; on v3 every flag is sent explicitly.
Lists the versions of a secret, newest first (GET /api/v1/secret/{id}/secret-versions).
The route accepts user tokens only; machine identities get PermissionDeniedError.
Sets environment variables (default process.env) from the secrets of a folder; the key is
the variable name. Existing variables are kept unless override. Returns { name: key } for
the variables that were set (never values).
Updates a secret (PATCH /api/v4/secrets/{name}): value, rename, comment, tags (replaces
the set). Every update bumps the version. When no value is sent the response value is empty.
Updates several secrets (PATCH /api/v4/secrets/batch, mode failOnNotFound by default).
Secrets of one project environment (
client.secrets).