Delete a vault

Delete a Vault.

DELETE /api/v1/cloud/vaults/{vault_id}

Deletes a Vault and returns a deletion confirmation.

Path parameters

Parameter	Type	Description
vault_id	string	Vault ID with the vault_ prefix

Headers

Header	Required	Description
Authorization	Yes	Bearer $QODER_PAT

Example request

curl -X DELETE https://api.qoder.com/api/v1/cloud/vaults/vault_019e3bb940277f0db05ab74291acf6ef \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "id": "vault_019e3bb940277f0db05ab74291acf6ef",
  "type": "vault_deleted"
}

Successful deletion is signalled by "type": "vault_deleted" in the response body.

Errors

HTTP	Type	Trigger
401	TOKEN_INVALID	Missing or invalid authentication token
404	not_found_error	Vault does not exist or is not accessible

See Errors for the full error envelope.

Related

Authenticate with vaults

Store and inject secrets safely into agent sessions.