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

# Delete a fault

> Permanently deletes a fault object. This action cannot be undone.



## OpenAPI

````yaml /api/en/faults.yaml delete /fault/{faultId}
openapi: 3.0.3
info:
  title: Altostrat Faults API
  version: 1.0.0
  description: >-
    Query, resolve, and share SDX fault data through the public `/fault` gateway
    path. Use query parameters on `/fault` for site-specific and recent fault
    views.
servers:
  - url: https://v1.api.altostrat.io
    description: Production API Server
security:
  - BearerAuth: []
tags:
  - name: Faults
    description: Manage and retrieve fault records.
  - name: Comments
    description: Add comments to existing faults.
  - name: Analytics
    description: Access aggregated fault data and reports.
  - name: Access Tokens
    description: Generate temporary access tokens.
paths:
  /fault/{faultId}:
    delete:
      tags:
        - Faults
      summary: Delete a fault
      description: Permanently deletes a fault object. This action cannot be undone.
      operationId: deleteFault
      parameters:
        - name: faultId
          in: path
          required: true
          description: The unique identifier of the fault to delete.
          schema:
            type: string
            example: flt_31pkd1t8FvW7qZv0jG2a9kH5mB1
      responses:
        '204':
          description: The fault was successfully deleted.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  responses:
    Unauthorized:
      description: Unauthorized - The API key is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            type: authentication_error
            code: api_key_invalid
            message: The provided API key is invalid.
            doc_url: https://docs.altostrat.io/errors/api_key_invalid
    Forbidden:
      description: Forbidden - The API key does not have permission to perform this action.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            type: permission_error
            code: permission_denied
            message: You do not have the required scope to perform this action.
            doc_url: https://docs.altostrat.io/errors/permission_denied
    NotFound:
      description: Not Found - The requested resource does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            type: invalid_request_error
            code: resource_missing
            message: 'No such fault: ''flt_xxxxxxxxxxxxxxxxxxxxxxxxxx'''
            doc_url: https://docs.altostrat.io/errors/resource_missing
    ServerError:
      description: Internal Server Error - An unexpected error occurred on our servers.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            type: api_error
            code: internal_server_error
            message: >-
              An internal error occurred. Please try again or contact support if
              the issue persists.
            doc_url: https://docs.altostrat.io/errors/internal_server_error
  schemas:
    ErrorResponse:
      type: object
      properties:
        type:
          type: string
          description: A broad category for the error (e.g., 'invalid_request_error').
          example: invalid_request_error
        code:
          type: string
          description: A short, unique string identifying the specific error.
          example: parameter_missing
        message:
          type: string
          description: A human-readable description of what went wrong.
          example: The 'resource_id' parameter is required for this request.
        doc_url:
          type: string
          description: >-
            A direct link to the documentation page for this specific error
            code.
          example: https://docs.altostrat.io/errors/parameter_missing
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        API requests are authenticated using a JSON Web Token (JWT) provided in
        the `Authorization` header.

````