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

# Delete Compliance Scan

> Stops the scan and then deletes its record, addressed by name in `X-Enkrypt-Scan`.

The stop comes **first**: if the scanning service cannot be reached the call fails with `502` and the scan is left intact, rather than being deleted while it keeps polling the workspace.

The scan's log-file history is deleted with it. Export List Compliance Log Files first if you need to keep the coverage record.

Requires the **governance officer** role on the project your API key belongs to. The organization owner is not exempt — an owner without the role gets `403` — and an individual (non-organization) account cannot hold the role at all.



## OpenAPI

````yaml DELETE /compliance/delete-scan
openapi: 3.0.0
info:
  title: Enkrypt AI APIs
  version: 2.0.0
servers:
  - url: https://api.enkryptai.com
security:
  - apiKeyAuth: []
tags:
  - name: Guardrails
  - name: Code of Conduct
  - name: Endpoints
  - name: Redteam
    description: >-
      Red Team API: submit red-team / threat-modeling / playground / eval runs,
      then poll run status, records, results and compliance. Also two-phase
      threat modeling (categories + data), dataset retrieval, model health,
      findings and risk mitigation. The previous task-based Red Team API is
      under **Archived**.
  - name: Deployments
  - name: AI Proxy
  - name: Leaderboard
  - name: Archived
  - name: MCP Hub
    description: >-
      MCP Hub vulnerability scanning APIs. Submitting scans (the POST endpoints)
      is open to all authenticated callers. The scan **retrieval** APIs — Get
      Scan Job Status, Get Complete Scan Results, List Scans, and Get MCP Hub
      Scan Statistics (the GET endpoints) — are an **enterprise data-license
      feature**: they require your organization to have MCP Hub API access
      enabled by Enkrypt, otherwise they return `403`. Contact us at
      support@enkryptai.com to enable access.
  - name: MCP Registry Servers
  - name: MCP Gateways
  - name: MCP Playground
  - name: Skill Scanner
    description: >-
      Skill Scanner APIs: submit an agent skill (a directory inside a git
      repository) for security scanning, then read the verdict, the risk level
      and the full report. Scanning is asynchronous — a scan takes roughly 30–90
      seconds, so `POST /skill-hub/scan` returns a `scan_id` you poll.


      You see your organization's scans and nobody else's. The identity comes
      from your API key, never from your request — sending `user_email` is a
      `400`.


      For an organization or project API key, scans are filed under the
      **organization**, so every member sees every scan the organization has
      run, whichever project or member submitted it. For an individual account
      it is simply your own scans. Either way List Skill Scans needs no
      parameter to say who you are.
  - name: Compliance
    description: >-
      Compliance APIs: connect a ChatGPT Enterprise workspace, then keep reading
      its compliance logs and scanning every message through one of your saved
      guardrails.


      Every endpoint here — reads as well as writes — requires the **governance
      officer** role on the project your API key belongs to. The organization
      owner is **not** exempt: an owner who has not been granted the role gets
      `403` like anyone else. An individual (non-organization) account cannot
      hold the role at all, so compliance is an organization-only feature today.


      A scan is addressed by name in the `X-Enkrypt-Scan` header, within the
      project its API key belongs to. Message text is never stored: Get
      Compliance Message fetches it live from the provider, and only while the
      provider still holds it.
paths:
  /compliance/delete-scan:
    delete:
      tags:
        - Compliance
      summary: Delete Compliance Scan
      description: >-
        Stops the scan and then deletes its record, addressed by name in
        `X-Enkrypt-Scan`.


        The stop comes **first**: if the scanning service cannot be reached the
        call fails with `502` and the scan is left intact, rather than being
        deleted while it keeps polling the workspace.


        The scan's log-file history is deleted with it. Export List Compliance
        Log Files first if you need to keep the coverage record.


        Requires the **governance officer** role on the project your API key
        belongs to. The organization owner is not exempt — an owner without the
        role gets `403` — and an individual (non-organization) account cannot
        hold the role at all.
      operationId: compliance_delete_scan
      parameters:
        - name: X-Enkrypt-Scan
          in: header
          required: true
          schema:
            title: Scan Name
            type: string
            description: >-
              The scan's saved name, within the project your API key belongs to.
              Letters, numbers, spaces and `_ & - . /`; must start and end with
              a letter or a number; at most 64 characters.
            example: ChatGPT Enterprise
      responses:
        '200':
          description: Scan stopped and deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComplianceDeleteScanResponse'
              examples:
                deleted:
                  summary: Deleted
                  value:
                    message: Scan deleted
                    scan_id: 11111111-2222-3333-4444-555555555555
        '400':
          $ref: '#/components/responses/ComplianceBadRequest'
        '401':
          $ref: '#/components/responses/ComplianceUnauthorized'
        '403':
          $ref: '#/components/responses/ComplianceForbidden'
        '404':
          $ref: '#/components/responses/ComplianceNotFound'
        '500':
          $ref: '#/components/responses/ComplianceServerError'
        '502':
          description: >-
            The scan could not be stopped, so it was **not** deleted. Retry once
            the scanning service is reachable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComplianceErrorResponse'
components:
  schemas:
    ComplianceDeleteScanResponse:
      title: ComplianceDeleteScanResponse
      type: object
      properties:
        message:
          type: string
          example: Scan deleted
        scan_id:
          type: string
          format: uuid
          description: The scan that was deleted.
    ComplianceErrorResponse:
      title: ComplianceErrorResponse
      type: object
      description: Error envelope returned by the compliance APIs.
      properties:
        error:
          type: string
          example: Scan not found
    ComplianceGatewayErrorResponse:
      title: ComplianceGatewayErrorResponse
      type: object
      description: >-
        Error envelope returned by the gateway for a request it refuses before
        it reaches the compliance service — an unknown body field, a value
        outside an enum, a malformed scan name, or a failed permission check.
      properties:
        code:
          type: integer
          example: 403
        error:
          type: string
          example: Forbidden
        message:
          type: string
          example: Access Denied
        request_id:
          type: string
        time:
          type: number
  responses:
    ComplianceBadRequest:
      description: >-
        Bad Request — a malformed or non-JSON body, an unknown or unexpected
        field, a value outside an enum, a missing or malformed `X-Enkrypt-Scan`,
        a missing `event_id`, out-of-range paging, an empty update, or an
        attempt to change `provider` / `workspace_id` / `scan_id`.
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ComplianceErrorResponse'
              - $ref: '#/components/schemas/ComplianceGatewayErrorResponse'
    ComplianceUnauthorized:
      description: Unauthorized — missing or invalid `apikey` header.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ComplianceGatewayErrorResponse'
    ComplianceForbidden:
      description: >-
        Forbidden — the caller does not hold the **governance officer** role on
        this project, or the account is an individual (non-organization)
        account, which cannot hold that role. The organization owner is not
        exempt: an owner without the role is refused here too.
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ComplianceErrorResponse'
              - $ref: '#/components/schemas/ComplianceGatewayErrorResponse'
    ComplianceNotFound:
      description: >-
        Not Found — no scan of that name in the project your API key belongs to
        (or, on Get Compliance Message, no record of that `event_id`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ComplianceErrorResponse'
    ComplianceServerError:
      description: Internal Server Error.
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ComplianceErrorResponse'
              - $ref: '#/components/schemas/ComplianceGatewayErrorResponse'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: apikey

````