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

# Enrich document

> Request a pre-signed URL to upload a document directly to Bigdata.com. The response contains a single-use url and the document id. Send a **PUT request** to that URL with the document file as the body to complete the upload. Bigdata then **enriches** the document (extraction, structure and annotation of the content) and **indexes** it; when done, it is available for the Search and Research Agent.



## OpenAPI

````yaml /api-rest/openapi/openapi_content_data.json post /contents/v1/documents
openapi: 3.1.0
info:
  title: Bigdata Content API
  description: API for managing and accessing private content documents uploaded by users.
  version: 1.0.0
servers:
  - url: https://api.bigdata.com/
security:
  - ApiKeyAuth: []
paths:
  /contents/v1/documents:
    post:
      tags:
        - Documents
      summary: Enrich document
      description: >-
        Request a pre-signed URL to upload a document directly to Bigdata.com.
        The response contains a single-use url and the document id. Send a **PUT
        request** to that URL with the document file as the body to complete the
        upload. Bigdata then **enriches** the document (extraction, structure
        and annotation of the content) and **indexes** it; when done, it is
        available for the Search and Research Agent.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - file_name
              properties:
                file_name:
                  type: string
                  description: Name of the file being uploaded (e.g. research_report.pdf).
                  example: research_report.pdf
                published_ts:
                  type: string
                  format: date-time
                  description: >-
                    Optional publication date/time for the document (ISO 8601).
                    This date will be used as the reference timestamp for search
                    and retrieval.
                  example: '2025-06-15T10:30:00Z'
                tags:
                  type: array
                  items:
                    type: string
                  description: >-
                    Optional list of tag names to apply to the document. Tags
                    can be used to search and filter documents in the Search and
                    Research-Agent services.
                  example:
                    - Research Team
                share_with_org:
                  type: boolean
                  description: >-
                    If true, all members of your organization can access the
                    file once it is processed. If false, only you can access the
                    processed content.
                  example: true
            example:
              file_name: research_report.pdf
              published_ts: '2025-06-15T10:30:00Z'
              tags:
                - Research Team
              share_with_org: true
      responses:
        '200':
          description: >-
            Pre-signed URL and document id. PUT the file to the URL to complete
            the upload; use the id with Get document to poll for status.
          content:
            application/json:
              schema:
                type: object
                required:
                  - url
                  - id
                properties:
                  url:
                    type: string
                    format: uri
                    description: >-
                      Single-use pre-signed URL. Send a PUT request to this URL
                      with the document file as the body.
                  id:
                    type: string
                    description: >-
                      Document content ID (32-character uppercase hexadecimal).
                      Use this with Get document to check processing status and
                      perform operations on the document.
              example:
                url: >-
                  https://s3.amazonaws.com/com.ravenpack.private-content-drop.smart-topics-prod-nvirginia/uploads/F22BC027BCE166BC89DD2A81358DA2F1?AWSAccessKeyId=...
                id: F22BC027BCE166BC89DD2A81358DA2F1
        '400':
          description: Invalid request body (e.g. missing file_name or invalid format).
        '401':
          description: Unauthorized - Invalid or missing API key.
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: >-
        Your API key. Include it in every request as the X-API-KEY header.
        Create and manage keys in the Developer Platform.

````