Delete entity
Deletes an entity by id or slug; at least one identifier is required. Defaults to soft delete, which hides the entity from public list/detail reads and keeps the slug reserved. Use deleteMode=hard for permanent deletion; hard delete removes the row and releases the slug. Deleting an entity that is the current productService provider for Product/Service records returns 409 listing the child ids; delete or migrate the children first, or merge the provider so the joins repoint atomically. Response is SlugDelete with deletedMode, slugReleased, and slug so callers can confirm exactly which delete behavior was applied.
Authentication
AuthorizationBearer
User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key
OR
X-API-Keystring
Admin API key for system-to-system write operations
Query parameters
id
Owner-scoped resource UUID selector.
slug
Owner-scoped resource slug selector.
deleteMode
Delete mode: soft (reversible) or hard (permanent)
Allowed values:
sourceType
Write provenance source type.
sourceDetail
Source detail or reviewer reference for the write.
sourceProvider
Provider name for provider-native IDs or slugs.
sourceProviderId
Provider-native source ID.
sourceProviderSlug
Provider-native source slug.
actorType
Actor type; inferred as agent when agentChassis and agentModel are supplied, or as employee from an authenticated user JWT session.
Allowed values:
agentChassis
Agent chassis token for agent-authored writes.
agentModel
Agent model id for agent-authored writes.
Response
OK
deletedMode
Applied delete mode: soft or hard.
slug
Slug affected by the delete operation.
slugReleased
True only after hard delete. False after soft delete because the hidden row still reserves the slug.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error