> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Disable email sending for a domain

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Turns off email sending for a domain.

The domain itself stays connected to the app and keeps serving the site. Only the ability to send mail from it goes away, and mail falls back to Base44's own sending address.

Base44 also tries to remove the domain from the mail provider, but a 200 does not promise that part succeeded: if the provider cannot be reached the local configuration is still removed and the call still succeeds.

This is not reversible: turning the domain back on means running [Enable email sending for a domain](/api-reference/enable-email-sending-for-a-domain) again, publishing DNS records again, and waiting for verification again.

Send `domain` when the app has more than one. The response body is empty, so read the status code.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json delete /api/apps/{app_id}/custom-email-domains
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/custom-email-domains:
    delete:
      summary: Disable email sending for a domain
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Turns off email sending for a domain.


        The domain itself stays connected to the app and keeps serving the site.
        Only the ability to send mail from it goes away, and mail falls back to
        Base44's own sending address.


        Base44 also tries to remove the domain from the mail provider, but a 200
        does not promise that part succeeded: if the provider cannot be reached
        the local configuration is still removed and the call still succeeds.


        This is not reversible: turning the domain back on means running [Enable
        email sending for a
        domain](/api-reference/enable-email-sending-for-a-domain) again,
        publishing DNS records again, and waiting for verification again.


        Send `domain` when the app has more than one. The response body is
        empty, so read the status code.


        <Note>This endpoint accepts a personal API key. Workspace API keys are
        not authorized for it and are rejected with a 403.</Note>
      operationId: >-
        delete_email_domain_endpoint_api_apps__app_id__custom_email_domains_delete
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the app whose email domains you want to work with.
            title: App Id
          description: ID of the app whose email domains you want to work with.
          example: 6820f3a4e7b91d003c45a1f2
        - name: domain
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Domain to delete. Required when multiple domains exist.
            title: Domain
          description: Domain to delete. Required when multiple domains exist.
      responses:
        '200':
          description: Email sending is off for this domain. The body is empty.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteEmailResponse'
        '400':
          description: >-
            This app has more than one email domain and you did not say which to
            act on. Send `domain`.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You don't have access to this app, you used a workspace API key, or
            the email domain is suspended. A suspended domain says why in the
            message.
        '404':
          description: >-
            This app has no email domain set up, or none matching the `domain`
            you sent.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    DeleteEmailResponse:
      properties: {}
      type: object
      title: DeleteEmailResponse
      description: Response for deleting email domain.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````