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

# Get clean message content

> Returns deterministic clean JSON content for one message. Attachment output is metadata only; attachment contents are not parsed by this endpoint.



## OpenAPI

````yaml /openapi-app.json get /mailbox/messages/{message_id}/content
openapi: 3.1.0
info:
  description: Programmatic access to your Qubrics email infrastructure.
  title: Qubrics API
  version: 1.0.0
servers:
  - description: API v1
    url: https://app.qubrics.com/api/v1
security:
  - bearerAuth: []
  - oauth2: []
paths:
  /mailbox/messages/{message_id}/content:
    get:
      tags:
        - Mailbox API
      summary: Get clean message content
      description: >-
        Returns deterministic clean JSON content for one message. Attachment
        output is metadata only; attachment contents are not parsed by this
        endpoint.
      operationId: mailboxListContent
      parameters:
        - in: path
          name: message_id
          required: true
          schema:
            description: Message ID.
            type: string
        - in: query
          name: part
          required: false
          schema:
            description: Body part to return. `auto` prefers text when available.
            enum:
              - auto
              - text
              - html
            type: string
        - in: query
          name: max_body_chars
          required: false
          schema:
            description: Maximum body characters to return before truncation.
            maximum: 1000000
            minimum: 1
            type: integer
        - in: query
          name: strip_signature
          required: false
          schema:
            description: When true, remove detected email signatures.
            type: boolean
        - in: query
          name: strip_quotes
          required: false
          schema:
            description: When true, remove quoted reply text.
            type: boolean
        - in: query
          name: include_links
          required: false
          schema:
            description: When true, include links extracted from the body.
            type: boolean
        - in: query
          name: include_html
          required: false
          schema:
            description: When true, include HTML content when available.
            type: boolean
        - in: query
          name: include_headers
          required: false
          schema:
            description: Header detail to include in the response.
            enum:
              - none
              - selected
              - full
            type: string
        - in: query
          name: include_attachments
          required: false
          schema:
            description: Attachment detail to include. Contents are not returned.
            enum:
              - none
              - metadata
            type: string
        - in: header
          name: If-None-Match
          required: false
          schema:
            description: Weak ETag from a previous response. Returns 304 when unchanged.
            type: string
        - description: >-
            Mailbox public ID to target when the credential grants access to
            more than one mailbox. Omit when the credential is scoped to exactly
            one mailbox.
          in: query
          name: mailbox_id
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MailboxMessageContentResponse'
          description: Clean message content
        '304':
          description: Not modified
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Invalid query parameter
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
          description: Message not found
      security:
        - bearerAuth: []
        - oauth2:
            - mailbox.read
components:
  schemas:
    MailboxMessageContentResponse:
      allOf:
        - $ref: '#/components/schemas/SuccessEnvelope'
        - properties:
            data:
              $ref: '#/components/schemas/MailboxMessageContent'
            meta:
              $ref: '#/components/schemas/ResponseMeta'
          required:
            - data
          type: object
      unevaluatedProperties: false
    ApiError:
      additionalProperties: false
      properties:
        error:
          additionalProperties: false
          properties:
            code:
              description: Machine-readable error code
              enum:
                - invalid_parameter
                - missing_parameter
                - authentication_required
                - insufficient_permissions
                - not_found
                - conflict
                - limit_exceeded
                - idempotency_conflict
                - payload_too_large
                - validation_error
                - rate_limit_exceeded
                - service_unavailable
                - internal_error
              example: invalid_parameter
              type: string
            doc_url:
              description: Link to relevant documentation
              type: string
            errors:
              description: >-
                Accumulated per-field issues for validation errors. Only present
                on 400/422 responses.
              items:
                $ref: '#/components/schemas/ApiErrorDetail'
              type: array
            message:
              description: Human-readable error description
              type: string
            param:
              description: The parameter that caused the error
              type: string
            retryable:
              description: >-
                Whether the caller may safely retry this request. 4xx are
                typically false (except 429); 5xx are typically true.
              example: false
              type: boolean
          required:
            - code
            - message
            - retryable
          type: object
        meta:
          additionalProperties: false
          properties:
            request_id:
              example: req_clxxxxxxxxxxxxxxxxxxxxxxxxx
              type: string
          required:
            - request_id
          type: object
        ok:
          enum:
            - false
          type: boolean
      required:
        - ok
        - error
        - meta
      type: object
    SuccessEnvelope:
      properties:
        meta:
          additionalProperties: {}
          properties: {}
          type: object
        ok:
          enum:
            - true
          type: boolean
      required:
        - ok
        - meta
      type: object
    MailboxMessageContent:
      additionalProperties: false
      properties:
        attachments:
          description: >-
            Attachment metadata only. Attachment contents are not parsed by this
            endpoint.
          items:
            $ref: '#/components/schemas/MailboxAttachment'
          type: array
        body:
          additionalProperties: false
          properties:
            cleaned_html:
              description: >-
                HTML with recognised quotes and signatures removed according to
                the stripping options. Original HTML remains in html. This is
                not sanitised content. Null when HTML is absent, not requested,
                truncated, or exceeds cleaning limits.
              type:
                - string
                - 'null'
            extracted_links:
              items:
                type: string
              type: array
            format:
              enum:
                - text
                - html
              type:
                - string
                - 'null'
            html:
              description: >-
                HTML body when requested. Returned as a JSON string and not as
                rendered content.
              type:
                - string
                - 'null'
            html_cleaning:
              additionalProperties: false
              description: >-
                HTML cleaning outcome; null when HTML is absent or not
                requested. Cleaning accepts at most 20,000 elements and 128
                nested elements. Unrecognised quote and signature formats remain
                unchanged.
              properties:
                quotes_stripped:
                  type: boolean
                signature_stripped:
                  type: boolean
                status:
                  enum:
                    - complete
                    - source_truncated
                    - limit_exceeded
                  type: string
              required:
                - status
                - signature_stripped
                - quotes_stripped
              type:
                - object
                - 'null'
            is_truncated:
              type: boolean
            quotes_stripped:
              type: boolean
            signature_stripped:
              type: boolean
            text:
              type:
                - string
                - 'null'
            truncated_at_chars:
              type:
                - integer
                - 'null'
          required:
            - format
            - text
            - html
            - cleaned_html
            - html_cleaning
            - is_truncated
            - truncated_at_chars
            - signature_stripped
            - quotes_stripped
            - extracted_links
          type: object
        dates:
          additionalProperties: false
          properties:
            received_at:
              type:
                - string
                - 'null'
            sent_at:
              type:
                - string
                - 'null'
          required:
            - received_at
            - sent_at
          type: object
        headers:
          $ref: '#/components/schemas/MailboxContentHeaders'
        id:
          description: Message ID
          type: string
        participants:
          additionalProperties: false
          properties:
            bcc:
              items:
                $ref: '#/components/schemas/MailboxAddress'
              type: array
            cc:
              items:
                $ref: '#/components/schemas/MailboxAddress'
              type: array
            from:
              anyOf:
                - $ref: '#/components/schemas/MailboxAddress'
                - type: 'null'
            reply_to:
              items:
                $ref: '#/components/schemas/MailboxAddress'
              type: array
            to:
              items:
                $ref: '#/components/schemas/MailboxAddress'
              type: array
          required:
            - from
            - to
            - cc
            - bcc
            - reply_to
          type: object
        states:
          additionalProperties: false
          properties:
            email_state:
              type:
                - string
                - 'null'
            option_hash:
              type: string
          required:
            - email_state
            - option_hash
          type: object
        subject:
          type:
            - string
            - 'null'
        thread_id:
          type:
            - string
            - 'null'
      required:
        - id
        - thread_id
        - subject
        - participants
        - dates
        - body
        - headers
        - attachments
        - states
      type: object
    ResponseMeta:
      additionalProperties: false
      properties:
        request_id:
          example: req_clxxxxxxxxxxxxxxxxxxxxxxxxx
          type: string
      required:
        - request_id
      type: object
    ApiErrorDetail:
      additionalProperties: false
      properties:
        code:
          description: >-
            Machine-readable issue code from the validator (e.g. zod issue
            code).
          example: invalid_string
          type: string
        field:
          description: Dot-path of the offending request field.
          example: recipient.email
          type: string
        message:
          description: Human-readable issue description.
          type: string
      required:
        - field
        - code
        - message
      type: object
    MailboxAttachment:
      additionalProperties: false
      properties:
        content_id:
          description: Content ID for inline attachments, when present.
          type:
            - string
            - 'null'
        content_type:
          example: application/pdf
          type: string
        disposition:
          example: attachment
          type:
            - string
            - 'null'
        download_url:
          description: >-
            Short-lived URL for this exact attachment. Fetch it promptly; if it
            expires, call the message or attachment metadata endpoint again to
            receive a fresh URL.
          example: >-
            https://app.qubrics.com/api/v1/mailbox/messages/msg_123/attachment-downloads/attref_abc123?download_token=...
          type: string
        filename:
          example: invoice.pdf
          type:
            - string
            - 'null'
        id:
          description: Attachment blob ID.
          type: string
        size_bytes:
          example: 12345
          type:
            - integer
            - 'null'
      required:
        - id
        - filename
        - content_type
        - size_bytes
        - disposition
        - content_id
      type: object
    MailboxContentHeaders:
      additionalProperties: false
      properties:
        full:
          items:
            additionalProperties: false
            properties:
              name:
                type: string
              value:
                type: string
            required:
              - name
              - value
            type: object
          type:
            - array
            - 'null'
        mode:
          enum:
            - none
            - selected
            - full
          type: string
        selected:
          properties:
            in_reply_to:
              type:
                - string
                - 'null'
            message_id:
              items:
                type: string
              type: array
            references:
              items:
                type: string
              type: array
            reply_to:
              items:
                $ref: '#/components/schemas/MailboxAddress'
              type: array
          required:
            - message_id
            - in_reply_to
            - references
            - reply_to
          type:
            - object
            - 'null'
      required:
        - mode
        - selected
        - full
      type: object
    MailboxAddress:
      additionalProperties: false
      properties:
        email:
          example: agent@example.com
          format: email
          type: string
        name:
          example: Support
          type:
            - string
            - 'null'
      required:
        - email
        - name
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: API Key
      description: >-
        Qubrics API key. Use a root API key for Management API routes, or a
        mailbox credential for Mailbox API routes. Obtain keys from the
        dashboard under API Keys.
      scheme: bearer
      type: http
    oauth2:
      description: >-
        Use the authorisation-code flow with S256 PKCE and
        resource=https://qubrics.com/api. The user selects the team, API access
        and mailboxes during consent. OAuth access tokens authenticate HTTP API
        requests; use separate credentials for SMTP and IMAP.
      flows:
        authorizationCode:
          authorizationUrl: https://app.qubrics.com/oauth/authorize
          refreshUrl: https://app.qubrics.com/oauth/token
          scopes:
            analytics.*: All analytics operations
            analytics.read: View key usage analytics and verification logs
            billing.*: All billing operations
            billing.auto_topup: Configure auto top-up settings
            billing.read: View balance, transactions, invoices
            billing.topup: Purchase balance top-ups
            calendar.read: Read calendars and events in this mailbox
            calendar.write: >-
              Create calendars and create, edit and delete events in this
              mailbox
            domain.*: All domain operations
            domain.create: Add sending domains
            domain.delete: Remove domains
            domain.read: List/view domains and DNS status
            domain.verify: Trigger domain verification
            email.receive: Authorise email reception
            email.send: Send email through the HTTP API
            key.*: All key management operations
            key.create: Create new API keys (both root and mailbox)
            key.read: List/view API keys and their metadata
            key.revoke: Revoke API keys
            key.rotate: Rotate API keys
            logs.*: All log operations
            logs.read: View delivery logs
            mailbox.admin.*: All mailbox admin operations
            mailbox.admin.create: Create mailboxes (admin-level)
            mailbox.admin.delete: Delete mailboxes (admin-level)
            mailbox.admin.manage: Manage all mailbox settings
            mailbox.admin.read: List/view mailboxes (admin-level)
            mailbox.drafts.write: Create and edit saved mailbox drafts
            mailbox.read: Read mailbox contents (folders, messages)
            mailbox.settings.update: Update own mailbox settings (signature, auto-reply)
            provider.*: All provider operations
            provider.create: Add email provider accounts (Google, Microsoft, SMTP)
            provider.delete: Remove provider accounts
            provider.read: List/view provider accounts and connection status
            provider.update: Update provider settings, refresh tokens
            routing.*: All routing operations
            routing.create: Create delivery groups
            routing.delete: Remove delivery groups
            routing.read: List/view delivery groups and routing rules
            routing.update: Update delivery group configuration
            team.*: All team operations
            team.members.invite: Invite team members
            team.members.remove: Remove team members
            team.members.roles: Change member roles
            team.read: View team settings and members
            team.update: Update team settings
            webhook.*: All webhook operations
            webhook.create: Create webhook subscriptions
            webhook.delete: Delete webhook subscriptions
            webhook.manage: Rotate signing secret + send test events
            webhook.read: List/view webhook subscriptions
            webhook.update: Update webhook URL, event types, enabled flag
          tokenUrl: https://app.qubrics.com/oauth/token
      type: oauth2

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.