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

> Uploads a CSV, JSON, JSONL or NDJSON file.

Send a multipart file up to 45 MiB. For larger files, POST `{filename, bytes}`,
PUT the file to `upload_url`, then POST `{upload_ticket}` to finish.
Maximum: 100 MB and 100,000 rows. Finish the upload within two hours.



## OpenAPI

````yaml /openapi.json post /v1/files
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/files:
    post:
      tags:
        - Files
      summary: Create File
      description: >-
        Uploads a CSV, JSON, JSONL or NDJSON file.


        Send a multipart file up to 45 MiB. For larger files, POST `{filename,
        bytes}`,

        PUT the file to `upload_url`, then POST `{upload_ticket}` to finish.

        Maximum: 100 MB and 100,000 rows. Finish the upload within two hours.
      operationId: create_file_v1_files_post
      requestBody:
        required: true
        content:
          multipart/form-data:
            example:
              file: |
                name,company
                Saarth Shah,Sixtyfour
            schema:
              type: object
              required:
                - file
              properties:
                file:
                  type: string
                  format: binary
          application/json:
            schema:
              oneOf:
                - additionalProperties: false
                  properties:
                    filename:
                      description: Name of the file to upload, including its extension.
                      maxLength: 255
                      minLength: 1
                      title: Filename
                      type: string
                    bytes:
                      description: Plaintext bytes, up to 100 MB.
                      exclusiveMinimum: 0
                      title: Bytes
                      type: integer
                  required:
                    - filename
                    - bytes
                  title: FileUploadRequest
                  type: object
                - additionalProperties: false
                  properties:
                    upload_ticket:
                      description: >-
                        Ticket returned when the upload starts. Submit after
                        sending the file to upload_url.
                      format: uuid
                      title: Upload Ticket
                      type: string
                  required:
                    - upload_ticket
                  title: FileUploadCompletion
                  type: object
            examples:
              ticket:
                summary: Request an upload ticket
                value:
                  filename: leads.csv
                  bytes: 1048
              complete:
                summary: Finalize an uploaded file
                value:
                  upload_ticket: 11111111-1111-4111-8111-111111111111
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/PublicFile'
                  - $ref: '#/components/schemas/FileUploadTicket'
                title: Response Create File V1 Files Post
              examples:
                multipart:
                  summary: multipart/form-data → finalized file
                  value:
                    file_id: file_11111111-1111-4111-8111-111111111111
                    filename: leads.csv
                    format: csv
                    bytes: 1048
                    row_count: 10
                    created_at: '2026-11-13T10:00:00Z'
                    download_url: https://api.sixtyfour.ai/storage/download/DOWNLOAD_TOKEN
                    expires_at: '2026-11-13T10:15:00Z'
                ticket:
                  summary: JSON filename + bytes → upload ticket
                  value:
                    object: file_upload
                    upload_ticket: 11111111-1111-4111-8111-111111111111
                    upload_url: https://uploads.example.com/upload?token=UPLOAD_TOKEN
                    upload_method: PUT
                    expires_at: '2026-11-13T12:00:00Z'
                complete:
                  summary: JSON upload_ticket → finalized file
                  value:
                    file_id: file_11111111-1111-4111-8111-111111111111
                    filename: leads.csv
                    format: csv
                    bytes: 1048
                    row_count: 10
                    created_at: '2026-11-13T10:00:00Z'
                    download_url: https://api.sixtyfour.ai/storage/download/DOWNLOAD_TOKEN
                    expires_at: '2026-11-13T10:15: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'
          description: Conflict
        '413':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Request Entity Too Large
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobValidationError'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Too Many Requests
        '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:
    PublicFile:
      properties:
        file_id:
          type: string
          title: File Id
          description: File identifier to use as input_file_id.
        filename:
          type: string
          title: Filename
          description: Name of the file.
        format:
          type: string
          title: Format
          description: File format.
        bytes:
          type: integer
          title: Bytes
          description: File size in bytes.
        row_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Row Count
          description: Number of records, when available.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Creation time in UTC, in ISO 8601 format.
        download_url:
          type: string
          title: Download Url
          description: URL to download the file. Valid for 15 minutes.
        expires_at:
          type: string
          format: date-time
          title: Expires At
          description: Download URL expiry time in UTC, in ISO 8601 format.
      type: object
      required:
        - file_id
        - filename
        - format
        - bytes
        - created_at
        - download_url
        - expires_at
      title: PublicFile
    FileUploadTicket:
      properties:
        object:
          type: string
          const: file_upload
          title: Object
          description: Always file_upload.
          default: file_upload
        upload_ticket:
          type: string
          format: uuid
          title: Upload Ticket
          description: Ticket to submit after the upload finishes. Valid for two hours.
        upload_url:
          type: string
          title: Upload Url
          description: URL to upload the file to. Use the returned upload_method.
        upload_method:
          type: string
          const: PUT
          title: Upload Method
          description: HTTP method to use with upload_url. Always PUT.
          default: PUT
        expires_at:
          type: string
          format: date-time
          title: Expires At
          description: Upload ticket expiry time in UTC, in ISO 8601 format.
      type: object
      required:
        - upload_ticket
        - upload_url
        - expires_at
      title: FileUploadTicket
    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
        - 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.