Skip to main content
DELETE
/
v1
/
workspaces
/
{workspace_id}
/
byok-keys
/
{byok_key_id}
Delete BYOK key
import requests

url = "https://api.auriko.ai/v1/workspaces/{workspace_id}/byok-keys/{byok_key_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "propagation_status": "pending",
  "message": "<string>"
}
Requires byok:write scope. Naturally idempotent. Audit event: byok_key.deleted.
If the deleted key was the provider’s default, Auriko stops routing through it within about 5 minutes. May return 202 with propagation_status: "pending" while the change takes effect.
All parameters, request/response schemas, and examples are auto-generated from the OpenAPI specification.

Authorizations

​
Authorization
string
header
required

API key authentication. Keys start with ak_ prefix. Example: Authorization: Bearer ak_live_xxxxxxxxxxxx

Path Parameters

​
workspace_id
string<uuid>
required

Workspace identifier

​
byok_key_id
string<uuid>
required

BYOK key identifier

Response

Accepted — deletion queued for propagation

Response when a BYOK deletion is committed but edge propagation is pending.

​
id
string<uuid>
required

Identifier of the affected BYOK key

​
propagation_status
enum<string>
required

Propagation status

Available options:
pending
​
message
string
required

Human-readable status message