> ## 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.

# Trigger connector sync

> Queues a new synchronization run for an **investment_research** or **sharepoint** connector. For **investment_research**, send a JSON body with **`date_limit`** (calendar date, `YYYY-MM-DD`) so the broker sync includes research from that date onward according to platform rules. For **sharepoint**, send an empty JSON body (`{}`). Only content not already ingested will be synced.



## OpenAPI

````yaml /api-rest/openapi/openapi_content_data.json post /contents/v1/connectors/{connector_id}/sync
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/connectors/{connector_id}/sync:
    post:
      tags:
        - Connectors
      summary: Trigger connector sync
      description: >-
        Queues a new synchronization run for an **investment_research** or
        **sharepoint** connector. For **investment_research**, send a JSON body
        with **`date_limit`** (calendar date, `YYYY-MM-DD`) so the broker sync
        includes research from that date onward according to platform rules. For
        **sharepoint**, send an empty JSON body (`{}`). Only content not already
        ingested will be synced.
      parameters:
        - name: connector_id
          in: path
          required: true
          description: >-
            UUID of the **investment_research** or **sharepoint** connector to
            resync.
          schema:
            type: string
            format: uuid
            example: 019a9612-bfad-758c-884e-37dd8c6ad2cb
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectorSyncRequest'
            example:
              date_limit: '2026-01-01'
      responses:
        '200':
          description: Sync request was accepted and queued for the connector.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorSyncResponse'
              example:
                connector_id: 019a9612-bfad-758c-884e-37dd8c6ad2cb
                date_limit: '2026-01-01'
                status: accepted
        '400':
          description: >-
            Invalid request (e.g. unsupported connector type, missing or invalid
            `date_limit` for **investment_research**, or a non-empty body for
            **sharepoint**).
        '401':
          description: Unauthorized - Invalid or missing API key.
        '404':
          description: No connector found with this ID, or the user does not have access.
components:
  schemas:
    ConnectorSyncRequest:
      type: object
      description: >-
        Body for **POST /contents/v1/connectors/{connector_id}/sync**. For
        **investment_research** connectors, send **`date_limit`**. For
        **sharepoint** connectors, send an empty object (`{}`).
      properties:
        date_limit:
          type: string
          format: date
          description: >-
            Calendar date (`YYYY-MM-DD`). Required for **investment_research**
            connectors; retriggers broker synchronization including research
            from this date forward per platform rules. Must be omitted for
            **sharepoint** connectors.
          example: '2026-01-01'
    ConnectorSyncResponse:
      type: object
      description: Acknowledgement after a sync trigger is accepted.
      properties:
        connector_id:
          type: string
          format: uuid
          description: Connector that was targeted.
          example: 019a9612-bfad-758c-884e-37dd8c6ad2cb
        date_limit:
          type: string
          format: date
          description: >-
            Echo of the requested date limit. Returned only for
            **investment_research** connectors.
          example: '2026-01-01'
        status:
          type: string
          description: >-
            Processing state of the request (for example `accepted` when
            queued).
          example: accepted
      required:
        - connector_id
        - status
  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.

````