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

# Launch Sanitization

> Queues an asynchronous redaction job for a file. The system detects the file's media type (video, audio, image, or text) and dispatches it to the appropriate redaction pipeline. At least one policyId or manual target must be provided. The job runs asynchronously and returns immediately with a job ID and output S3 location.



## OpenAPI

````yaml POST /files/{id}/redact
openapi: 3.0.1
info:
  title: Indora Labs API
  description: >-
    Comprehensive API for search, ingestion, file ops, redaction, detections,
    audit trail, and case management. All endpoints return strongly-typed JSON
    with explicit field descriptions and examples.
  version: 1.0.0
  license:
    name: Proprietary
servers:
  - url: https://api.indoralabs.com
security:
  - apiKeyAuth: []
tags:
  - name: Search
  - name: Uploads
  - name: Files
  - name: Redactions
  - name: Detections
  - name: Cases
  - name: Audit
  - name: Auth
  - name: Embeddings
  - name: Policy
paths:
  /files/{id}/redact:
    post:
      tags:
        - Files
      summary: Start a redaction job
      description: >-
        Queues an asynchronous redaction job for a file. The system detects the
        file's media type (video, audio, image, or text) and dispatches it to
        the appropriate redaction pipeline. At least one policyId or manual
        target must be provided. The job runs asynchronously and returns
        immediately with a job ID and output S3 location.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID of the file to redact.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                policyIds:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  description: List of policy document IDs used to resolve redaction rules.
                targets:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  description: >-
                    Manual redaction targets such as labels or semantic
                    instructions.
                sampleFps:
                  type: integer
                  minimum: 1
                  maximum: 30
                  description: >-
                    Frame sampling rate for video redaction. Lower values
                    increase speed. Higher values increase accuracy.
                executionMode:
                  type: string
                  enum:
                    - detect
                    - burn
                    - auto
                  default: auto
                  description: >-
                    Redaction execution behavior. 'auto' performs detection and
                    burning. 'detect' runs detection only. 'burn' applies
                    existing redaction boxes without detection.
      responses:
        '202':
          description: Redaction job successfully queued.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                    description: Indicates the job was accepted.
                  jobId:
                    type: string
                    format: uuid
                    description: Unique job identifier.
                  status:
                    type: string
                    enum:
                      - pending
                    description: Initial job status.
                  outputS3Uri:
                    type: string
                    description: >-
                      S3 URI where the redacted file will be written after
                      processing completes.
                  detectedType:
                    type: string
                    enum:
                      - video
                      - audio
                      - image
                      - text
                    description: Detected media type used to determine processing pipeline.
                required:
                  - ok
                  - jobId
                  - status
                  - outputS3Uri
                  - detectedType
        '400':
          description: >-
            Invalid request. Occurs when no policyIds or targets are provided,
            or payload validation fails.
        '401':
          description: Unauthorized. API key missing or invalid.
        '404':
          description: Original file not found or storage path unavailable.
        '500':
          description: Internal server error while creating or enqueueing the job.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````