Bulk secrets API now supports create, update, delete in one request
You can now create, update, or delete multiple secrets for your Worker in a single request using the bulk secrets endpoint.
- Include a secret with a value to create or update.
- Set a secret to
nullto delete. - Secrets not included in the request are left unchanged.
The following example creates API_KEY, updates the already existing DB_PASSWORD, and deletes OLD_SECRET:
<div><div><span>{</span></div></div><div><div><span> </span><span>"</span><span>secrets</span><span>"</span><span>:</span><span> </span><span>{</span></div></div><div><div><span> </span><span>"</span><span>API_KEY</span><span>"</span><span>:</span><span> </span><span>{</span><span> </span><span>"</span><span>type</span><span>"</span><span>:</span><span> </span><span>"secret_text"</span><span>,</span><span> </span><span>"</span><span>name</span><span>"</span><span>:</span><span> </span><span>"API_KEY"</span><span>,</span><span> </span><span>"</span><span>text</span><span>"</span><span>:</span><span> </span><span>"my-api-key"</span><span> </span><span>},</span></div></div><div><div><span> </span><span>"</span><span>DB_PASSWORD</span><span>"</span><span>:</span><span> </span><span>{</span><span> </span><span>"</span><span>type</span><span>"</span><span>:</span><span> </span><span>"secret_text"</span><span>,</span><span> </span><span>"</span><span>name</span><span>"</span><span>:</span><span> </span><span>"DB_PASSWORD"</span><span>,</span><span> </span><span>"</span><span>text</span><span>"</span><span>:</span><span> </span><span>"my-db-password"</span><span> </span><span>},</span></div></div><div><div><span> </span><span>"</span><span>OLD_SECRET</span><span>"</span><span>:</span><span> </span><span>null</span></div></div><div><div><span> </span><span>}</span></div></div><div><div><span>}</span></div></div>
You can do the same from the command line using wrangler secret bulk:
<div><div><span>npx</span><span> </span><span>wrangler</span><span> </span><span>secret</span><span> </span><span>bulk</span><span> </span><span><</span><span> </span><span>secrets.json</span></div></div>
To delete a key, set its value to null in the JSON file. Deletion is not supported with .env files.
Each request supports up to 100 total operations (creates, updates, and deletes combined).
Fetched June 3, 2026



