Skip to main content
DELETE
Delete BYOK key
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