secrets

Delete a secret. Its sealed value is erased; the placeholder stops working.

delete/v1/egress-secrets/{name}

Request

  • Base URL: https://api.withruntime.com
  • URL: https://api.withruntime.com/v1/egress-secrets/{name}
  • Auth: HTTP bearer

Path parameters

namestring required

The environment variable the placeholder is in, inside every sandbox of the organization. Upper case letters, digits and underscores.

Example:OPENAI_API_KEY

Headers

Idempotency-Keystring

Replaying the same key with the same request within 24 hours returns the first result and never repeats the effect. A refusal is not kept: a request refused before it ran (no_capacity, busy, a limit) runs afresh when sent again with its key. The SDKs send one automatically; the server makes one when absent and returns it in the idempotency-key response header.

Response

Success

namestring
deletedboolean
enforcedboolean

True when every server running the organization's sandboxes, and every server still holding an earlier version, confirmed the change; a sandbox that starts or wakes later is given it before it runs. False while a server has not confirmed it yet: each server asks Runtime for changes every 15 seconds, and one that has not heard from Runtime for a minute sends no secret's value until it has.

Changes

No recorded changes to this operation across all 1 revision of this API.