> ## Documentation Index > Fetch the complete documentation index at: https://docs.bizzyco.ai/llms.txt > Use this file to discover all available pages before exploring further. # Delete domain > Delete a domain from the authenticated organization. Verified domains can be deleted at any time; their DNS records at the external DNS host are left untouched. Registered Bizzy-managed domains can only be deleted once their registration has expired and their DNS zone holds no records beyond the zone's built-in ones (the apex NS set and SOA) — disable email for the domain first so Bizzy removes the email records it manages, and remove any remaining records yourself. A blocked deletion returns 409 with code REGISTERED_DOMAIN_NOT_EXPIRED, REGISTERED_DOMAIN_RENEWAL_IN_FLIGHT (a renewal is already queued or running for the domain), or REGISTERED_DOMAIN_DNS_NOT_EMPTY (which lists the blocking records in the error details). If the domain had email enabled, Bizzy also retires its email configuration — revoking the sending credential and removing the domain from the email provider. That cleanup is best-effort: if the provider is unreachable, the deletion still succeeds and any credential Bizzy could not revoke is recorded rather than lost track of. ## OpenAPI ````yaml /api-reference/openapi.json delete /v1/domains/{id} openapi: 3.1.0 info: title: Bizzy API version: 1.0.0 description: Bizzy API for managing businesses, customers, contacts, and more. servers: - url: https://api.bizzyco.ai description: Production security: [] tags: - name: Automations description: Manage workflow automation rules x-group: Automations - name: Automation Executions description: View automation execution history x-group: Automations - name: Businesses description: Manage business profiles x-group: Businesses - name: Business Offerings description: Manage products and services offered by businesses x-group: Businesses - name: Business Online Presences description: Manage websites and social media links x-group: Businesses - name: Business Physical Presences description: Manage physical locations and addresses x-group: Businesses - name: Business Profile description: View and update business profile details x-group: Businesses - name: Contacts description: Manage contact records x-group: Contacts - name: Contact Addresses description: Manage mailing addresses for contacts x-group: Contacts - name: Contact Emails description: Manage email addresses for contacts x-group: Contacts - name: Contact Phone Numbers description: Manage phone numbers for contacts x-group: Contacts - name: Customers description: Manage customer records x-group: Customers - name: Customer Transactions description: View customer transaction history x-group: Customers - name: Domains description: Manage domain names x-group: Domains - name: Domain Contacts description: Manage contacts associated with domains x-group: Domains - name: Domain Registrations description: Manage domain registration records x-group: Domains - name: Files description: Manage file uploads and downloads x-group: Files - name: File Access Links description: Manage shareable file access links x-group: Files - name: Folders description: Organize files into folders x-group: Files - name: Messages description: Manage email messages x-group: Messages - name: Message Attachments description: Access message file attachments x-group: Messages - name: Message Contacts description: View contacts associated with messages x-group: Messages - name: Tasks description: Manage task records x-group: Tasks - name: Task Assignees description: Manage user assignments to tasks x-group: Tasks - name: Task Activity description: View task activity and change history x-group: Tasks paths: /v1/domains/{id}: delete: tags: - Domains summary: Delete domain description: >- Delete a domain from the authenticated organization. Verified domains can be deleted at any time; their DNS records at the external DNS host are left untouched. Registered Bizzy-managed domains can only be deleted once their registration has expired and their DNS zone holds no records beyond the zone's built-in ones (the apex NS set and SOA) — disable email for the domain first so Bizzy removes the email records it manages, and remove any remaining records yourself. A blocked deletion returns 409 with code REGISTERED_DOMAIN_NOT_EXPIRED, REGISTERED_DOMAIN_RENEWAL_IN_FLIGHT (a renewal is already queued or running for the domain), or REGISTERED_DOMAIN_DNS_NOT_EMPTY (which lists the blocking records in the error details). If the domain had email enabled, Bizzy also retires its email configuration — revoking the sending credential and removing the domain from the email provider. That cleanup is best-effort: if the provider is unreachable, the deletion still succeeds and any credential Bizzy could not revoke is recorded rather than lost track of. operationId: deleteDomain parameters: - schema: type: string format: uuid description: Domain UUID required: true description: Domain UUID name: id in: path responses: '204': description: Delete domain headers: X-RateLimit-Limit: schema: type: integer description: Maximum burst of requests the tier allows per minute X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window after this request X-RateLimit-Reset: schema: type: integer description: Seconds until the allowance is fully replenished '400': description: Invalid input content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: Insufficient permissions content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ApiError' '409': description: >- Deletion refused by the registered-domain gate (error code REGISTERED_DOMAIN_NOT_EXPIRED, REGISTERED_DOMAIN_RENEWAL_IN_FLIGHT, or REGISTERED_DOMAIN_DNS_NOT_EMPTY — the last carries the blocking records in details.blockingRecords) content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded for the account tier (error code RATE_LIMITED) headers: X-RateLimit-Limit: schema: type: integer description: Maximum burst of requests the tier allows per minute X-RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window after this request X-RateLimit-Reset: schema: type: integer description: Seconds until the allowance is fully replenished Retry-After: schema: type: integer description: Seconds to wait before the next request will be accepted content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - bearerAuth: [] components: schemas: ApiError: type: object properties: error: type: object properties: message: type: string code: type: string details: {} required: - message - code required: - error securitySchemes: bearerAuth: type: http scheme: bearer description: API key authentication via Bearer token ````