domains

Delete a domain

Delete a domain, and by default the assets no other proof covers.

The optional body's delete_assets controls the cascade; omitting the body (as every legacy client does) keeps legacy's behaviour and removes the assets under the domain that no other active proof still covers.

Args: domain_id (int): The domain's identifier. db (AsyncSession): Request-scoped database session. context (ActiveContext): Resolved caller identity and scope. body (DeleteDomainRequest | None): Optional cascade switch.

Returns: SuccessResponse: The legacy delete envelope, echoing the removed id.

Raises: NotFoundError: No domain with that id is visible to the caller. PermissionError: Cerbos denied the composite delete.

delete/v1/domains/{domain_id}

Request

  • Base URL
    https://api.ethiack.com (the document declares no server; this is the origin it was published from)
  • Auth
    none declared

Path parameters

domain_idinteger required

Request body

delete_assetsboolean

Also remove the assets under this domain that no other active proof covers. Defaults to true, the legacy behaviour.

Response

Successful Response

codeinteger required
descriptionstring required
successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.