API Endpoint

DELETE /management/slugs/{name}

Archive a slug policy template when it is safe to remove.

DELETE /management/slugs/{name}

Endpoint context

Use these endpoints from internal tooling or your frontend backend to inspect licenses, manage slug policy templates, provisioning API keys, webhook endpoint configuration/logs, and offline JWT signing keys. Management routes require the management bootstrap key configured via MANAGEMENT_API_KEYS or MANAGEMENT_API_KEY.

Requires management API key auth.
Default slug cannot be deleted.
Deletion is a soft delete: archived slugs are hidden from active usage and listing.
Slugs with non-revoked, non-expired licenses cannot be deleted.

bash

curl -sS -X DELETE http://localhost:8080/management/slugs/legacy-beta \
  -H "Authorization: Bearer management_key_dev_123456"

Request body

json

{} (no request body)

Response body

json

{
  "deleted": true
}

Response field types

deleted

boolean

True when deletion succeeds.

Error codes

400

Invalid slug name format in path.

401

Missing or invalid management API key.

404

Slug not found.

409

Slug cannot be deleted (default or has non-revoked, non-expired licenses).

500

Unexpected server or storage error.

Back to API overview