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

# Create Monitor From A File

> Creates a monitor from a file.

Returns `status: starting` once the file is checked. Rows are added in the background and `status` becomes
`active` when all are in. Sending the same request again returns the same monitor.



## OpenAPI

````yaml /openapi.json post /v1/monitors/upload
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for people and companies: research agents that investigate,
    resolve identities, map relationships and surface risk signals.
  contact:
    name: Sixtyfour
    url: https://sixtyfour.ai/
    email: support@sixtyfour.ai
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sixtyfour.ai
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - name: Search
    description: Run deep and filter searches over Sixtyfour's data.
  - name: Workflow
    description: Create, run, and manage enrichment workflows.
  - name: Workflow Schedules
    description: Create and manage recurring schedules for workflows.
  - name: Account
    description: Manage and inspect your account and credit balance.
  - name: Feedback
    description: >-
      Tell us a result was wrong, missing or outdated, and report problems with
      the API, the docs or a tool.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Start, continue and read Atlas investigations: attribution graph,
      workspace files, reports and exports.
paths:
  /v1/monitors/upload:
    post:
      tags:
        - Monitors V1
      summary: Create Monitor From A File
      description: >-
        Creates a monitor from a file.


        Returns `status: starting` once the file is checked. Rows are added in
        the background and `status` becomes

        `active` when all are in. Sending the same request again returns the
        same monitor.
      operationId: upload_monitor_v1_monitors_upload_post
      parameters:
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 255
              - type: 'null'
            description: >-
              Makes a retry safe. Sending the same request again with the same
              key returns the monitor the first request created.
            title: Idempotency-Key
          description: >-
            Makes a retry safe. Sending the same request again with the same key
            returns the monitor the first request created.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_upload_monitor_v1_monitors_upload_post'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Monitor'
              example:
                monitor_id: 9a4d2c1b-6e7f-4a8b-b3c2-1d0e9f8a7b6c
                type: research
                name: Target accounts
                status: starting
                subject_type: company
                fields:
                  headcount: Number of employees
                frequency: 1w
                tier: low
                research_plan: null
                is_active: true
                disabled_reason: null
                webhook_url: https://example.com/webhooks/sixtyfour
                webhook_event_types:
                  - monitor.field.changed
                metadata: null
                row_count: 0
                active_row_count: 0
                last_run_at: null
                next_run_times: []
                created_at: '2026-11-13T10:00:00Z'
                updated_at: '2026-11-13T10:00:00Z'
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
              example:
                detail: >-
                  This Idempotency-Key is already in use. Use a new key for a
                  new request.
                error_code: idempotency_key_reused
                request_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                retryable: false
                param: null
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobValidationError'
          description: Unprocessable Entity
        '429':
          description: >-
            More than 10 requests per minute per organization. Retry after the
            delay in Retry-After.
          headers:
            Retry-After:
              description: Seconds before retrying
              schema:
                type: string
                example: '6'
          x-rate-limit:
            requests: 10
            period_seconds: 60
            scope: organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Service Unavailable
components:
  schemas:
    Body_upload_monitor_v1_monitors_upload_post:
      properties:
        file:
          type: string
          contentMediaType: application/octet-stream
          title: File
          description: CSV, JSON, JSONL or NDJSON file with one row per company or person.
        settings:
          type: string
          maxLength: 1000000
          title: Settings
          description: >-
            The monitor's settings as a JSON string: the same fields as `POST
            /v1/monitors`, without `rows`.
      type: object
      required:
        - file
        - settings
      title: Body_upload_monitor_v1_monitors_upload_post
    Monitor:
      properties:
        monitor_id:
          type: string
          title: Monitor Id
          description: Monitor identifier.
        type:
          type: string
          enum:
            - research
            - linkedin
          title: Type
          description: '`research` or `linkedin`.'
        name:
          type: string
          title: Name
          description: Name of the monitor.
        status:
          type: string
          enum:
            - starting
            - active
            - paused
            - failed
            - canceled
          title: Status
          description: >-
            `starting` while rows from a file are still being added, `active`
            when it runs on schedule, `paused` when switched off, `failed` when
            adding rows failed, `canceled` when canceled.
        subject_type:
          type: string
          enum:
            - company
            - person
          title: Subject Type
          description: What each row is.
        fields:
          additionalProperties: true
          type: object
          title: Fields
          description: The watched fields.
        frequency:
          type: string
          title: Frequency
          description: How often the monitor checks its rows.
        tier:
          type: string
          title: Tier
          description: Research depth for each check.
        research_plan:
          anyOf:
            - type: string
            - type: 'null'
          title: Research Plan
          description: Additional research instructions. Null when none were set.
        is_active:
          type: boolean
          title: Is Active
          description: If true, the monitor runs on its schedule.
        disabled_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Disabled Reason
          description: Why the monitor is not running. Null when it is running.
        webhook_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Webhook Url
          description: URL that receives the monitor's events. Null when none is set.
        webhook_event_types:
          items:
            type: string
          type: array
          title: Webhook Event Types
          description: Events sent to `webhook_url`.
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata
          description: Your own data stored on the monitor.
        row_count:
          type: integer
          title: Row Count
          description: Number of rows in the monitor.
        active_row_count:
          type: integer
          title: Active Row Count
          description: Number of rows that are still checked.
        last_run_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Run At
          description: >-
            Start time of the most recent check in UTC. Null before the first
            check.
        next_run_times:
          items:
            type: string
          type: array
          title: Next Run Times
          description: Up to three upcoming check times in UTC. Empty when not running.
        created_at:
          type: string
          title: Created At
          description: Creation time in UTC, in ISO 8601 format.
        updated_at:
          type: string
          title: Updated At
          description: Last update time in UTC, in ISO 8601 format.
      type: object
      required:
        - monitor_id
        - type
        - name
        - status
        - subject_type
        - fields
        - frequency
        - tier
        - is_active
        - webhook_event_types
        - row_count
        - active_row_count
        - next_run_times
        - created_at
        - updated_at
      title: Monitor
      examples:
        - active_row_count: 2
          created_at: '2025-12-30T18:04:11.482913+00:00'
          fields:
            headcount: Current number of employees
            latest_funding: Most recent funding round and amount
          frequency: 1d
          is_active: true
          last_run_at: '2026-01-05T09:00:04+00:00'
          metadata:
            crm_list: enterprise
          monitor_id: 5b0f6a1c-2d3e-4f70-8a9b-1c2d3e4f5a6b
          name: Target accounts
          next_run_times:
            - '2026-01-06T09:00:00+00:00'
            - '2026-01-07T09:00:00+00:00'
            - '2026-01-08T09:00:00+00:00'
          row_count: 2
          status: active
          subject_type: company
          tier: low
          type: research
          updated_at: '2026-01-05T09:00:04.118204+00:00'
          webhook_event_types:
            - monitor.field.changed
          webhook_url: https://example.com/hooks/sixtyfour
    PublicJobError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
      title: PublicJobError
    PublicJobValidationError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
        errors:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Errors
          description: >-
            Individual validation failures, each with a parameter location
            (`loc`), message (`msg`), and error type (`type`).
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
        - errors
      title: PublicJobValidationError
    V1ErrorCode:
      type: string
      enum:
        - invalid_cursor
        - request_in_progress
        - limit_exceeded
        - entity_type_mismatch
        - unsupported_file
        - invalid_upload
        - file_too_large
        - items_not_available
        - list_not_ready
        - job_not_finished
        - not_found
        - validation_error
        - rate_limited
        - internal_error
        - unavailable
        - unauthenticated
        - forbidden
        - insufficient_credits
        - idempotency_key_reused
        - export_source_changed
        - job_execution_changed
        - job_failed
        - item_failed
        - aborted
        - workflow_changed
        - workflow_locked
        - workflow_not_runnable
        - timed_out
      title: V1ErrorCode
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Sixtyfour API key.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        An OAuth access token from `POST /oauth/token`, sent as `Authorization:
        Bearer <token>`. An API key sent as a bearer token is refused with 401.
        When both headers are sent, the bearer token is used.

````

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