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

# Delete an Identity Provider

> Delete an Identity Provider specified by ID from this Organization. This will remove the association and delete the underlying Identity Provider. Members will no longer be able to authenticate using this Identity Provider.

export const Scopes = ({scopes = []}) => {
  return <div>
      <div class="api-section-heading flex flex-col gap-y-4 w-full">
        <div class="flex items-baseline border-b pb-2.5 border-gray-100 dark:border-gray-800 w-full">
          <h4 class="api-section-heading-title flex-1 mb-0">Scopes</h4>
          <div class="flex items-center"></div>
        </div>
      </div>
      <div class="mt-4">
        <div class="space-y-4 whitespace-normal prose prose-sm prose-gray dark:prose-invert overflow-wrap-anywhere [&_*]:overflow-wrap-anywhere">
          <p class="whitespace-pre-line text-xs">
            {"Scopes define permissions and access levels for API requests and authentication tokens."}
          </p>
        </div>
      </div>
      <div class="flex font-mono text-sm group/param-head param-head break-all relative mt-6" id="scopes-scopes">
        <div class="flex-1 flex flex-col content-start py-0.5 mr-5">
          <div class="flex items-center flex-wrap gap-2">
            <div class="absolute -top-1.5">
              <a href="#scopes-scopes" class="-ml-10 flex items-center opacity-0 border-0 group-hover/param-head:opacity-100 focus:opacity-100 focus:outline-0 py-2 [.expandable-content_&]:-ml-[2.1rem] group/link" aria-label="Navigate to header">
                ​
                <div class="w-6 h-6 rounded-md flex items-center justify-center shadow-sm text-gray-400 dark:text-white/50 dark:bg-background-dark dark:brightness-[1.35] dark:ring-1 dark:hover:brightness-150 bg-white ring-1 ring-gray-400/30 dark:ring-gray-700/25 hover:ring-gray-400/60 dark:hover:ring-white/20 group-focus/link:border-2 group-focus/link:border-primary dark:group-focus/link:border-primary-light">
                  <svg xmlns="http://www.w3.org/2000/svg" fill="gray" height="12px" viewBox="0 0 576 512">
                    <path d="M0 256C0 167.6 71.6 96 160 96h72c13.3 0 24 10.7 24 24s-10.7 24-24 24H160C98.1 144 48 194.1 48 256s50.1 112 112 112h72c13.3 0 24 10.7 24 24s-10.7 24-24 24H160C71.6 416 0 344.4 0 256zm576 0c0 88.4-71.6 160-160 160H344c-13.3 0-24-10.7-24-24s10.7-24 24-24h72c61.9 0 112-50.1 112-112s-50.1-112-112-112H344c-13.3 0-24-10.7-24-24s10.7-24 24-24h72c88.4 0 160 71.6 160 160zM184 232H392c13.3 0 24 10.7 24 24s-10.7 24-24 24H184c-13.3 0-24-10.7-24-24s10.7-24 24-24z"></path>
                  </svg>
                </div>
              </a>
            </div>
            {scopes.map((scope, index) => {
    return <span class="flex items-center px-2 py-0.5 rounded-md bg-gray-100/50 dark:bg-white/5 text-gray-600 dark:text-gray-200 font-medium break-all" style={{
      lineHeight: "1rem",
      fontSize: "0.75rem",
      fontFamily: 'var(--font-jetbrains-mono), ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace'
    }} data-component-part="field-info-pill" key={index}>
                  {scope}
                </span>;
  })}
          </div>
        </div>
      </div>
    </div>;
};

export const ApiReleaseLifecycle = ({releaseLifecycle = 'GA'}) => {
  const lifecycleMap = {
    ea: 'Early Access',
    ga: 'Generally Available',
    deprecated: 'Deprecated',
    planned: 'Planned',
    beta: 'Beta'
  };
  const LIFECYCLE_THEMES = {
    info: {
      light: {
        bg: 'lab(91.896% .077188 -6.94053)',
        text: 'lab(36.091% 25.9241 -68.0384)'
      },
      dark: {
        bg: 'lab(16.0426% 6.71726 -27.2409)',
        text: 'lab(72.6029% 4.08953 -41.9669)'
      }
    },
    secondary: {
      light: {
        bg: 'lab(90.8548% 11.3355 8.01476)',
        text: 'lab(47.5286% 56.4238 43.4706)'
      },
      dark: {
        bg: 'lab(16.3609% 37.191 25.6346)',
        text: 'lab(71.881% 41.5 29.4839)'
      }
    },
    danger: {
      light: {
        bg: 'lab(94.7916% -.0000298023 0)',
        text: 'lab(54.3656% 0 -.0000119209)'
      },
      dark: {
        bg: 'lab(13.232% 0 0)',
        text: 'lab(51.6164% 0 0)'
      }
    }
  };
  const LIFECYCLE_THEME_MAP = {
    ea: 'info',
    ga: 'info',
    beta: 'info',
    deprecated: 'secondary',
    planned: 'danger'
  };
  const lifecycle = releaseLifecycle.toLocaleLowerCase();
  const lifecycleText = lifecycleMap[lifecycle];
  if (!lifecycleText) {
    return null;
  }
  const theme = LIFECYCLE_THEMES[LIFECYCLE_THEME_MAP[lifecycle]];
  return <div>
      <div className="api-section-heading flex flex-col gap-y-4 w-full">
        <div className="flex items-baseline border-b pb-2.5 border-gray-100 dark:border-gray-800 w-full">
          <h4 className="api-section-heading-title flex-1 mb-0">
            Release Lifecycle
          </h4>
        </div>
      </div>
      <div className="flex font-mono text-sm group/param-head param-head break-all relative mt-2.5" id="releaselifecycle-lifecycle">
        <div className="flex-1 flex flex-col content-start py-0.5 mr-5">
          <div className="flex items-center flex-wrap gap-2">
            <div className="absolute -top-1.5">
              <a href="#releaselifecycle-lifecycle" className="-ml-10 flex items-center opacity-0 border-0 group-hover/param-head:opacity-100 focus:opacity-100 focus:outline-0 py-2 [.expandable-content_&]:-ml-[2.1rem] group/link" aria-label="Navigate to header">
                <div className="w-6 h-6 rounded-md flex items-center justify-center shadow-sm text-gray-400 dark:text-white/50 dark:bg-background-dark dark:brightness-[1.35] dark:ring-1 dark:hover:brightness-150 bg-white ring-1 ring-gray-400/30 dark:ring-gray-700/25 hover:ring-gray-400/60 dark:hover:ring-white/20 group-focus/link:border-2 group-focus/link:border-primary dark:group-focus/link:border-primary-light">
                  <svg xmlns="http://www.w3.org/2000/svg" fill="gray" height="12px" viewBox="0 0 576 512">
                    <path d="M0 256C0 167.6 71.6 96 160 96h72c13.3 0 24 10.7 24 24s-10.7 24-24 24H160C98.1 144 48 194.1 48 256s50.1 112 112 112h72c13.3 0 24 10.7 24 24s-10.7 24-24 24H160C71.6 416 0 344.4 0 256zm576 0c0 88.4-71.6 160-160 160H344c-13.3 0-24-10.7-24-24s10.7-24 24-24h72c61.9 0 112-50.1 112-112s-50.1-112-112-112H344c-13.3 0-24-10.7-24-24s10.7-24 24-24h72c88.4 0 160 71.6 160 160zM184 232H392c13.3 0 24 10.7 24 24s-10.7 24-24 24H184c-13.3 0-24-10.7-24-24s10.7-24 24-24z"></path>
                  </svg>
                </div>
              </a>
            </div>
            <span className="inline-flex items-center w-fit font-medium gap-1 py-0.5 px-2 rounded-md" style={{
    lineHeight: '1rem',
    fontSize: '0.75rem',
    fontFamily: 'var(--font-jetbrains-mono), ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace',
    backgroundColor: `light-dark(${theme.light.bg}, ${theme.dark.bg})`,
    color: `light-dark(${theme.light.text}, ${theme.dark.text})`,
    borderColor: `light-dark(color-mix(in oklab, ${theme.light.text} 25%, transparent), color-mix(in oklab, ${theme.dark.text} 25%, transparent))`
  }}>
              {lifecycleText}
            </span>
          </div>
        </div>
      </div>
    </div>;
};

<ApiReleaseLifecycle releaseLifecycle="EA" />

<Scopes scopes={["delete:my_org:identity_providers"]} />


## OpenAPI

````yaml myorganization-api-oas delete /identity-providers/{idp_id}
openapi: 3.1.0
info:
  title: My Organization API
  description: My Organization API
  termsOfService: https://auth0.com/web-terms/
  version: 1.0.0
  license:
    name: UNLICENSED
    url: https://auth0.com
servers:
  - url: https://{tenantDomain}/my-org/v1
    variables:
      tenantDomain:
        default: '{TENANT}.auth0.com'
        description: Auth0 Tenant Domain
  - url: https://{tenantDomain}/my-org
    variables:
      tenantDomain:
        default: '{TENANT}.auth0.com'
        description: Auth0 Tenant Domain
security: []
tags:
  - name: config
    description: Configuration
    x-displayName: Configuration
  - name: orgDetails
    description: Manage details related to your organization.
    x-displayName: Organization Details Management
  - name: idpManagement
    description: Manage Identity Providers for your Organization.
    x-displayName: Identity Provider Management
  - name: orgDomainManagement
    description: Manage domains related to your organization
    x-displayName: Domain Management
  - name: orgMemberManagement
    description: Manage members related to your organization
    x-displayName: Member Management
  - name: clientGrantManagement
    description: Manage client grants for your organization
    x-displayName: Client Grant Management
  - name: clientManagement
    description: Manage API clients for your organization
    x-displayName: Client Management
  - name: roles
    description: Manage roles for your organization
    x-displayName: Roles
paths:
  /identity-providers/{idp_id}:
    delete:
      tags:
        - idpManagement
      summary: Delete an Identity Provider
      description: >-
        Delete an Identity Provider specified by ID from this Organization. This
        will remove the association and delete the underlying Identity Provider.
        Members will no longer be able to authenticate using this Identity
        Provider.
      operationId: DeleteOrganizationIdentityProvider
      parameters:
        - $ref: '#/components/parameters/IdpIdPathParameter'
      responses:
        '204':
          $ref: '#/components/responses/DeleteIdentityProviderResponse'
        '400':
          $ref: '#/components/responses/ValidationErrorBadRequestResponse'
        '401':
          $ref: '#/components/responses/ClientErrorUnauthorizedResponse'
        '403':
          $ref: '#/components/responses/ClientErrorInsufficientScopeResponse'
        '404':
          $ref: '#/components/responses/ClientErrorNotFoundOrgOrIdpResponse'
        '429':
          $ref: '#/components/responses/ClientErrorTooManyRequestsResponse'
      security:
        - OAuth2ClientCredentials:
            - delete:my_org:identity_providers
        - OAuth2AuthCode:
            - delete:my_org:identity_providers
      x-codeSamples: []
components:
  parameters:
    IdpIdPathParameter:
      in: path
      name: idp_id
      required: true
      schema:
        $ref: '#/components/schemas/IdpId'
  responses:
    DeleteIdentityProviderResponse:
      description: The identity provider was successfully removed from the organization.
      headers:
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
        X-Auth0-Error-Kind:
          $ref: '#/components/headers/X-Auth0-Error-Kind'
    ValidationErrorBadRequestResponse:
      description: Invalid request body. The message will vary depending on the cause.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationErrorResponseContent'
          examples:
            validationErrorExample:
              $ref: '#/components/examples/ErrorValidationExample'
    ClientErrorUnauthorizedResponse:
      description: 'Unauthorized: token missing, invalid or expired.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseContent'
          examples:
            errorMissingTokenExample:
              $ref: '#/components/examples/ErrorMissingTokenExample'
    ClientErrorInsufficientScopeResponse:
      description: Insufficient scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseContent'
          examples:
            errorInsufficientScopeExample:
              $ref: '#/components/examples/ErrorInsufficientScopeExample'
    ClientErrorNotFoundOrgOrIdpResponse:
      description: Resource not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseContent'
          examples:
            errorOrgNotFoundExample:
              $ref: '#/components/examples/ErrorOrgNotFoundExample'
            ErrorIdpNotFoundExample:
              $ref: '#/components/examples/ErrorIdpNotFoundExample'
    ClientErrorTooManyRequestsResponse:
      description: >-
        Too many requests. Check the X-RateLimit-Limit, X-RateLimit-Remaining
        and X-RateLimit-Reset headers.
      headers:
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
        X-Auth0-Error-Kind:
          $ref: '#/components/headers/X-Auth0-Error-Kind'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseContent'
          examples:
            errorEndpointRateLimitExample:
              $ref: '#/components/examples/ErrorEndpointRateLimitExample'
  schemas:
    IdpId:
      type: string
      description: Identity provider identifier.
      readOnly: true
      pattern: ^con_[A-Za-z0-9]{16}$
    ValidationErrorResponseContent:
      type: object
      additionalProperties: false
      required:
        - type
        - status
        - title
        - validation_errors
      properties:
        type:
          type: string
          description: A URI that describes the error.
          format: uri
        status:
          type: integer
          description: The HTTP status code result of the request.
        title:
          type: string
          description: A brief description of the error.
        validation_errors:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorDetail'
    ErrorResponseContent:
      type: object
      additionalProperties: false
      required:
        - type
        - status
        - title
        - detail
      properties:
        type:
          type: string
          description: A URI that describes the error.
          format: uri
        status:
          type: integer
          description: The HTTP status code result of the request.
        title:
          type: string
          description: A brief description of the error.
        detail:
          type: string
          description: A detailed description of the error.
    ValidationErrorDetail:
      type: object
      additionalProperties: false
      required:
        - detail
      properties:
        detail:
          type: string
          description: A detailed description of the error.
        field:
          type: string
          description: The name of the invalid parameter.
        pointer:
          type: string
          description: >-
            JSON Pointer that points to the exact location of the error in a
            JSON document being validated.
        source:
          type: string
          description: >-
            Specifies the source of the error (e.g., body, query, or header in
            an HTML message).
  headers:
    X-RateLimit-Limit:
      description: The number of allowed requests in the current rate limit window.
      schema:
        type: integer
    X-RateLimit-Remaining:
      description: The number of remaining requests in the current rate limit window.
      schema:
        type: integer
    X-RateLimit-Reset:
      description: The Unix timestamp indicating when the current rate limit window resets.
      schema:
        type: integer
    Retry-After:
      description: >-
        The number of seconds the client should wait before making a new
        request.
      schema:
        type: integer
    X-Auth0-Error-Kind:
      description: >-
        An indicator that the rate limit exceeded a is global (per tenant)
        limit.
      schema:
        type: string
        enum:
          - global-rate-limit
  examples:
    ErrorValidationExample:
      value:
        type: https://auth0.com/api-errors#A0E-400-0003
        status: 400
        title: Validation Error
        validation_errors:
          - detail: is required
            field: data/property_name
            pointer: /property_name
            source: params
    ErrorMissingTokenExample:
      value:
        type: https://auth0.com/api-errors#A0E-401-0002
        status: 401
        title: Missing Token
        detail: No auth token provided.
    ErrorInsufficientScopeExample:
      value:
        type: https://auth0.com/api-errors#A0E-403-0002
        status: 403
        title: Insufficient Scope
        detail: >-
          The auth token lacks the required scope: Check the API documentation
          for the required scopes for this endpoint.
    ErrorOrgNotFoundExample:
      value:
        type: https://auth0.com/api-errors#A0E-404-0002
        status: 404
        title: Resource Not Found
        detail: The organization does not exist.
    ErrorIdpNotFoundExample:
      value:
        type: https://auth0.com/api-errors#A0E-404-0002
        status: 404
        title: Resource Not Found
        detail: The IdP does not exist.
    ErrorEndpointRateLimitExample:
      value:
        type: https://auth0.com/api-errors#A0E-429-0003
        status: 429
        title: Endpoint Rate Limit Exceeded
        detail: The endpoint request limit has been exceeded.
  securitySchemes:
    OAuth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          x-form-parameters:
            audience: /myorg-api/v1/
          scopes:
            read:my_org:configuration: Read organization configuration
            read:my_org:details: Read organization details
            update:my_org:details: Update organization details
            read:my_org:identity_providers: Read identity providers for organization
            create:my_org:identity_providers: Create identity provider for organization
            update:my_org:identity_providers: Update identity provider for organization
            delete:my_org:identity_providers: Delete identity provider for organization
            update:my_org:identity_providers_detach: Detach identity provider from organization
            create:my_org:identity_providers_domains: Associate organization domain with identity provider
            delete:my_org:identity_providers_domains: Remove organization domain from identity provider
            create:my_org:domains: Create domain for organization
            read:my_org:domains: Read domains for organization
            update:my_org:domains: Update domain for organization
            delete:my_org:domains: Delete domain for organization
            create:my_org:identity_providers_provisioning: Create provisioning configuration for identity provider
            update:my_org:identity_providers_provisioning: Update provisioning configuration for identity provider
            read:my_org:identity_providers_provisioning: Read provisioning configuration for identity provider
            delete:my_org:identity_providers_provisioning: Delete provisioning configuration for identity provider
            create:my_org:identity_providers_scim_tokens: Create a provisioning SCIM token for this identity provider
            read:my_org:identity_providers_scim_tokens: List the provisioning SCIM tokens for this identity provider
            delete:my_org:identity_providers_scim_tokens: Delete a provisioning SCIM configuration for an identity provider
            read:my_org:member_invitations: List member invitations for organization
            create:my_org:member_invitations: Create member invitations for organization
            delete:my_org:member_invitations: Delete member invitations for organization
            read:my_org:members: List members for organization
            delete:my_org:memberships: Delete members from organization without deleting underlying users
            read:my_org:member_roles: List Roles for members in organization
            create:my_org:member_roles: Create Roles for members in organization
            delete:my_org:member_roles: Delete Roles from members for organization
            create:my_org:client_grants: Create client grants for client in organization
            create:my_org:clients: Create API clients for organization
            read:my_org:clients: Read API clients for organization
            delete:my_org:clients: Delete API clients for organization
            read:my_org:permissions: Read permissions for a user
    OAuth2AuthCode:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: /authorize
          tokenUrl: /oauth/token
          x-form-parameters:
            audience: /myorg-api/v1/
          scopes:
            read:my_org:configuration: Read organization configuration
            read:my_org:details: Read organization details
            update:my_org:details: Update organization details
            read:my_org:identity_providers: Read identity providers for organization
            create:my_org:identity_providers: Create identity provider for organization
            update:my_org:identity_providers: Update identity provider for organization
            delete:my_org:identity_providers: Delete identity provider for organization
            update:my_org:identity_providers_detach: Detach identity provider from organization
            create:my_org:identity_providers_domains: Associate organization domain with identity provider
            delete:my_org:identity_providers_domains: Remove organization domain from identity provider
            create:my_org:domains: Create domain for organization
            read:my_org:domains: Read domains for organization
            update:my_org:domains: Update domain for organization
            delete:my_org:domains: Delete domain for organization
            create:my_org:identity_providers_provisioning: Create provisioning configuration for identity provider
            update:my_org:identity_providers_provisioning: Update provisioning configuration for identity provider
            read:my_org:identity_providers_provisioning: Read provisioning configuration for identity provider
            delete:my_org:identity_providers_provisioning: Delete provisioning configuration for identity provider
            create:my_org:identity_providers_scim_tokens: Create a provisioning SCIM token for this identity provider
            read:my_org:identity_providers_scim_tokens: List the provisioning SCIM tokens for this identity provider
            delete:my_org:identity_providers_scim_tokens: Delete a provisioning SCIM configuration for an identity provider
            read:my_org:member_invitations: List member invitations for organization
            create:my_org:member_invitations: Create member invitations for organization
            delete:my_org:member_invitations: Delete member invitations for organization
            read:my_org:members: List members for organization
            delete:my_org:memberships: Delete members from organization without deleting underlying users
            read:my_org:member_roles: List Roles for members in organization
            create:my_org:member_roles: Create Roles for members in organization
            delete:my_org:member_roles: Delete Roles from members for organization
            create:my_org:client_grants: Create client grants for client in organization
            create:my_org:clients: Create API clients for organization
            read:my_org:clients: Read API clients for organization
            delete:my_org:clients: Delete API clients for organization
            read:my_org:permissions: Read permissions for a user

````