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

# Start an investigation

> Start researching a subject in a new Atlas investigation.

The investigation is returned at once, so its workspace and graph can be read while the run works. It belongs
to your credential's team, which decides who else can see it.



## OpenAPI

````yaml /openapi.json post /v1/atlas/investigations
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/atlas/investigations:
    post:
      tags:
        - Atlas
      summary: Start an investigation
      description: >-
        Start researching a subject in a new Atlas investigation.


        The investigation is returned at once, so its workspace and graph can be
        read while the run works. It belongs

        to your credential's team, which decides who else can see it.
      operationId: start_investigation_v1_atlas_investigations_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartInvestigationRequest'
      responses:
        '202':
          description: Investigation and run identifiers for following progress.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/api__routers__atlas_workspace_api__RunStarted
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Invalid request body
                code: bad_request
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Invalid API key
                code: unauthenticated
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '402':
          description: >-
            Insufficient credits or no active subscription for this
            organization.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Insufficient API credits
                code: payment_required
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '403':
          description: Organization access is locked.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: >-
                  This organization no longer has access to Sixtyfour. Contact
                  your representative at Sixtyfour.
                code: forbidden
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '422':
          description: Request body failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: >-
            More than 120 requests per minute per organization. Retry after the
            delay in Retry-After.
          headers:
            Retry-After:
              description: Seconds before retrying
              schema:
                type: string
                example: '1'
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: >-
                  Rate limit exceeded: 120 requests per minute. Retry after 1
                  second.
                code: rate_limited
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
          x-rate-limit:
            requests: 120
            period_seconds: 60
            scope: organization
        '500':
          description: Unexpected server error. Retry with backoff.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Internal server error
                code: internal_error
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '503':
          description: >-
            Temporarily unavailable. Nothing was charged; retry after the
            `Retry-After` header.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Could not verify the API key right now. Retry shortly.
                code: unavailable
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
components:
  schemas:
    StartInvestigationRequest:
      properties:
        engine:
          type: string
          enum:
            - xhigh
            - scout
          title: Engine
          description: >-
            Research engine. `GET /v1/atlas/access` reports which ones this
            organization may run, and what each costs.
          default: xhigh
        research_plan:
          anyOf:
            - type: string
              maxLength: 100000
            - type: 'null'
          title: Research Plan
          description: Direction for this run. On a continue, what to look into next.
        struct:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Struct
          description: >-
            Optional output schema. Atlas researches open-endedly into the
            workspace either way.
        relentless:
          type: boolean
          title: Relentless
          description: >-
            Research until the budget runs out (the Atlas default). Set false to
            let a run with `struct` stop once every field is answered, charging
            the turns it used (at least one unit).
          default: true
        max_credits:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Credits
          description: >-
            How much research to buy, in credits (default: one unit of the
            engine price), up to 10 units. See [Credits &
            Pricing](/guides/credits-and-pricing).
        max_minutes:
          anyOf:
            - type: integer
              maximum: 1440
              minimum: 10
            - type: 'null'
          title: Max Minutes
          description: >-
            The most minutes of research time; waiting to retry does not count.
            When reached, the run writes up its findings, which can take a few
            minutes, and is charged only for the research it used. Default: no
            limit.
        dispatch_id:
          anyOf:
            - type: string
              maxLength: 128
              minLength: 8
            - type: 'null'
          title: Dispatch Id
          description: >-
            An idempotency key you generate. A retry with the same key returns
            the run already started instead of starting and charging a second
            one.
        task:
          anyOf:
            - type: string
              const: org_chart
            - type: 'null'
          title: Task
          description: Build an org chart with the xHigh research harness.
        lead_info:
          additionalProperties: true
          type: object
          title: Lead Info
          description: 'Who to investigate, e.g. {"name": "Jane Doe", "company": "Acme"}.'
        name:
          anyOf:
            - type: string
              maxLength: 1000
            - type: 'null'
          title: Name
          description: Title for the investigation. Derived from lead_info when unset.
        private:
          type: boolean
          title: Private
          description: >-
            Visible only to you, not your team. With an API key, the run is
            private to the person who created the key. Your team must allow
            private runs.
          default: false
      type: object
      required:
        - lead_info
      title: StartInvestigationRequest
    api__routers__atlas_workspace_api__RunStarted:
      properties:
        task_id:
          type: string
          title: Task Id
          description: Poll with `GET /job-status/{job_id}`.
        status:
          type: string
          title: Status
        investigation:
          $ref: '#/components/schemas/InvestigationReference'
          description: >-
            The investigation this run writes into; readable while the run
            works.
      type: object
      required:
        - task_id
        - status
        - investigation
      title: RunStarted
    HTTPValidationError:
      title: HTTPValidationError
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
        feedback:
          type: string
          description: How to report a problem with this response.
        code:
          type: string
          description: Stable error code, for programs.
        correlation_id:
          type: string
          description: This request's ID, also in `X-Correlation-ID`. Quote it to support.
      example:
        detail:
          - loc:
              - body
              - target_company
              - domain
            msg: Field required
            type: missing
            input: null
            ctx: {}
        code: invalid_request
        correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
        feedback: >-
          Problem with this response? POST /feedback with comment and operation;
          include correlation_id in your comment.
    InvestigationReference:
      properties:
        id:
          type: string
          title: Id
          description: Atlas investigation ID.
        workspace_url:
          type: string
          maxLength: 2083
          minLength: 1
          format: uri
          title: Workspace Url
          description: Canonical Sixtyfour app URL for the investigation's Atlas workspace.
      type: object
      required:
        - id
        - workspace_url
      title: InvestigationReference
      description: >-
        The Atlas investigation a run belongs to: its ID and a link to open it
        in

        the Sixtyfour app. Its files, findings and graph are served by the
        /v1/atlas

        endpoints.
    ValidationError:
      title: ValidationError
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          type: array
          items:
            oneOf:
              - type: string
              - type: integer
          description: Path to the field that failed validation.
          example:
            - body
            - target_company
            - domain
        msg:
          type: string
          description: Human-readable error message.
          example: Field required
        type:
          type: string
          description: Error code (e.g. 'missing', 'value_error').
          example: missing
        input:
          description: The offending input value (any type, may be null).
          nullable: true
          example: null
        ctx:
          type: object
          description: Optional error context.
          additionalProperties: true
          example: {}
  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.