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

# Send Feedback

> Records feedback on something Sixtyfour returned: a rating, verdicts on single fields, or a problem with the API, the docs or a tool.

Send at least one of `rating`, `message` or `fields`. `target` names a task, or one row of a workflow run's
results. A field left out of `fields` counts as not reviewed, and a later verdict from the same submitter
replaces only their own earlier one. Free.



## OpenAPI

````yaml /openapi.json post /feedback
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:
  /feedback:
    post:
      tags:
        - Feedback
      summary: Send Feedback
      description: >-
        Records feedback on something Sixtyfour returned: a rating, verdicts on
        single fields, or a problem with the API, the docs or a tool.


        Send at least one of `rating`, `message` or `fields`. `target` names a
        task, or one row of a workflow run's

        results. A field left out of `fields` counts as not reviewed, and a
        later verdict from the same submitter

        replaces only their own earlier one. Free.
      operationId: send_feedback_feedback_post
      parameters:
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 1
                maxLength: 255
              - type: 'null'
            description: >-
              The same key and request replays the first answer and saves
              nothing new; the same key with a different request returns `409`.
              Default: none, and every request saves new feedback.
            title: Idempotency-Key
          description: >-
            The same key and request replays the first answer and saves nothing
            new; the same key with a different request returns `409`. Default:
            none, and every request saves new feedback.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackReceipt'
        '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 message and
                  operation; include correlation_id in your message.
        '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 message and
                  operation; include correlation_id in your message.
        '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 message and
                  operation; include correlation_id in your message.
        '404':
          description: >-
            The target is not one your organization can read: no such task or
            workflow run, or another organization's.
          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: >-
                  No task with that id in your organization. Leave out target to
                  send general feedback.
                code: not_found
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with message and
                  operation; include correlation_id in your message.
        '409':
          description: >-
            This Idempotency-Key was already used for a different request.
            Nothing was saved.
          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 Idempotency-Key was already used for a different request;
                  nothing was saved. Use a new key for new feedback.
                code: conflict
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with message and
                  operation; include correlation_id in your message.
        '422':
          description: Request body failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: >-
            120 requests per minute per organization, with bursts of up to 20.
            Retry after the delay in Retry-After.
          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 per organization,
                  with bursts of up to 20. Retry after the delay in Retry-After.
                code: rate_limited
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with message and
                  operation; include correlation_id in your message.
          headers:
            Retry-After:
              description: Seconds before retrying
              schema:
                type: string
                example: '1'
            X-RateLimit-Requests:
              description: Requests replenished per period
              schema:
                type: string
                example: '120'
            X-RateLimit-Period:
              description: Replenishment period in seconds
              schema:
                type: string
                example: '60'
            X-RateLimit-Burst:
              description: Maximum requests available after idling
              schema:
                type: string
                example: '20'
          x-rate-limit:
            requests: 120
            period_seconds: 60
            burst: 20
            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 message and
                  operation; include correlation_id in your message.
        '503':
          description: >-
            Request capacity is temporarily unavailable. Retry after the delay
            in Retry-After.
          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: >-
                  Request capacity is temporarily unavailable. Retry after the
                  delay in Retry-After.
                code: unavailable
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with message and
                  operation; include correlation_id in your message.
          headers:
            Retry-After:
              description: Seconds before retrying
              schema:
                type: string
                example: '15'
components:
  schemas:
    FeedbackRequest:
      properties:
        target:
          anyOf:
            - oneOf:
                - $ref: '#/components/schemas/TaskTarget'
                - $ref: '#/components/schemas/WorkflowRowTarget'
                - $ref: '#/components/schemas/ChatMessageTarget'
                - $ref: '#/components/schemas/ChatSessionTarget'
                - $ref: '#/components/schemas/AtlasReportTarget'
              discriminator:
                propertyName: type
                mapping:
                  atlas_report: '#/components/schemas/AtlasReportTarget'
                  chat_message: '#/components/schemas/ChatMessageTarget'
                  chat_session: '#/components/schemas/ChatSessionTarget'
                  task: '#/components/schemas/TaskTarget'
                  workflow_row: '#/components/schemas/WorkflowRowTarget'
            - type: 'null'
          title: Target
          description: >-
            What the feedback is about: a task, workflow row, chat
            session/message, or Atlas report. Default: none, for feedback on the
            API, the docs or a tool in general.
        rating:
          anyOf:
            - type: string
              enum:
                - positive
                - negative
            - type: 'null'
          title: Rating
          description: 'Your overall verdict on the target. Default: none.'
        category:
          anyOf:
            - type: string
              enum:
                - incorrect_data
                - outdated_data
                - missing_data
                - wrong_match
                - error
                - slow
                - confusing
                - missing_feature
                - billing
                - privacy
                - other
            - type: 'null'
          title: Category
          description: >-
            What kind of feedback: `incorrect_data`, `outdated_data` (true once,
            not now), `missing_data`, `wrong_match` (the wrong person or
            company, or a result that does not fit the request), `error`,
            `slow`, `confusing` (docs, a parameter or a message),
            `missing_feature`, `billing`, `privacy` (something that should not
            be shared) or `other`. Default: none.
        impact:
          anyOf:
            - type: string
              enum:
                - blocked
                - worked_around
                - minor
            - type: 'null'
          title: Impact
          description: >-
            What the problem did to your work: it `blocked` it, you
            `worked_around` it, or it was `minor`. Default: none.
        message:
          anyOf:
            - type: string
              maxLength: 2000
              minLength: 1
            - type: 'null'
          title: Message
          description: >-
            What happened, and what would have helped. Leave out secrets and
            personal details the target does not already hold. Default: none.
        fields:
          items:
            $ref: '#/components/schemas/FieldVerdict'
          type: array
          maxItems: 200
          title: Fields
          description: >-
            Verdicts on single fields of the target, up to 200, each field once.
            Needs `target`. A field left out counts as not reviewed. Default:
            none.
        goal:
          anyOf:
            - type: string
              maxLength: 2000
              minLength: 1
            - type: 'null'
          title: Goal
          description: >-
            What you were trying to do, in general terms, without names or
            private details. Default: none.
        operation:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
            - type: 'null'
          title: Operation
          description: >-
            The endpoint or tool the feedback is about, such as `POST
            /search/query`, when there is no `target`. Default: none.
        source:
          anyOf:
            - $ref: '#/components/schemas/FeedbackSource'
            - type: 'null'
          description: 'Who wrote the feedback. Default: none.'
        reply_to:
          anyOf:
            - type: string
              maxLength: 320
              format: email
            - type: 'null'
          title: Reply To
          description: Where we may reply. Visible only to Sixtyfour support.
        replay_url:
          anyOf:
            - type: string
              maxLength: 2048
            - type: 'null'
          title: Replay Url
          description: >-
            Optional session replay for support; only approved replay hosts are
            linked.
      additionalProperties: false
      type: object
      title: FeedbackRequest
      examples:
        - category: outdated_data
          fields:
            - correct: jane@newco.com
              evidence_urls:
                - https://www.linkedin.com/in/janedoe
              path: email
              returned: jane@acme.com
              verdict: outdated
            - path: title
              verdict: correct
          impact: worked_around
          message: The email bounces. Her LinkedIn shows she left Acme in March.
          source:
            agent_name: lead-reviewer
            kind: agent
          target:
            task_id: enrich_7d1c0e52-5b8f-4c1a-9f0e-3a2b1c4d5e6f
            type: task
    FeedbackReceipt:
      properties:
        id:
          type: string
          title: Id
          description: The feedback's id. Read it back with `GET /feedback/{feedback_id}`.
        already_submitted:
          type: boolean
          title: Already Submitted
          description: >-
            True when this `Idempotency-Key` was already used for the same
            request: nothing new was saved, and `id` is the first submission's.
        target:
          anyOf:
            - oneOf:
                - $ref: '#/components/schemas/ResolvedTaskTarget'
                - $ref: '#/components/schemas/WorkflowRowTarget'
                - $ref: '#/components/schemas/ChatMessageTarget'
                - $ref: '#/components/schemas/ChatSessionTarget'
                - $ref: '#/components/schemas/AtlasReportTarget'
              discriminator:
                propertyName: type
                mapping:
                  atlas_report: '#/components/schemas/AtlasReportTarget'
                  chat_message: '#/components/schemas/ChatMessageTarget'
                  chat_session: '#/components/schemas/ChatSessionTarget'
                  task: '#/components/schemas/ResolvedTaskTarget'
                  workflow_row: '#/components/schemas/WorkflowRowTarget'
            - type: 'null'
          title: Target
          description: What the feedback is about, as saved.
        fields_recorded:
          type: integer
          title: Fields Recorded
          description: How many field verdicts the submission holds.
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - id
        - already_submitted
        - fields_recorded
        - created_at
      title: FeedbackReceipt
      examples:
        - already_submitted: false
          created_at: '2026-11-05T18:22:11Z'
          fields_recorded: 2
          id: 6a0b5d0e-8f1e-4c2a-b7d3-9e8f7a6b5c4d
          target:
            task_id: enrich_7d1c0e52-5b8f-4c1a-9f0e-3a2b1c4d5e6f
            type: task
    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 message and operation;
          include correlation_id in your message.
    TaskTarget:
      properties:
        type:
          type: string
          const: task
          title: Type
        task_id:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
              pattern: ^[A-Za-z0-9._-]+$
            - type: 'null'
          title: Task Id
          description: >-
            The `task_id` an async call or its webhook returned, or the Request
            ID (`X-Correlation-ID`) of a sync call. Send this or `dispatch_id`.
        dispatch_id:
          anyOf:
            - type: string
              maxLength: 128
              minLength: 8
            - type: 'null'
          title: Dispatch Id
          description: >-
            The `dispatch_id` you sent with the call, when it never answered
            with a `task_id`. Send this or `task_id`.
      additionalProperties: false
      type: object
      required:
        - type
      title: TaskTarget
    WorkflowRowTarget:
      properties:
        type:
          type: string
          const: workflow_row
          title: Type
        run_id:
          type: string
          maxLength: 200
          minLength: 1
          pattern: ^[A-Za-z0-9._-]+$
          title: Run Id
          description: 'The workflow run: the `job_id` that `POST /workflows/run` returned.'
        block:
          type: integer
          minimum: 1
          title: Block
          description: The `block_number` of the results file the row is in.
        row:
          type: integer
          minimum: 1
          title: Row
          description: The row's `_row_id` in that file.
      additionalProperties: false
      type: object
      required:
        - type
        - run_id
        - block
        - row
      title: WorkflowRowTarget
    ChatMessageTarget:
      properties:
        type:
          type: string
          const: chat_message
          title: Type
        session_id:
          type: string
          maxLength: 200
          minLength: 1
          pattern: ^[A-Za-z0-9._-]+$
          title: Session Id
          description: The chat in the Sixtyfour app.
        message_id:
          type: string
          maxLength: 200
          minLength: 1
          title: Message Id
          description: The assistant message rated with its thumbs.
      additionalProperties: false
      type: object
      required:
        - type
        - session_id
        - message_id
      title: ChatMessageTarget
    ChatSessionTarget:
      properties:
        type:
          type: string
          const: chat_session
          title: Type
        session_id:
          type: string
          maxLength: 200
          minLength: 1
          pattern: ^[A-Za-z0-9._-]+$
          title: Session Id
      additionalProperties: false
      type: object
      required:
        - type
        - session_id
      title: ChatSessionTarget
    AtlasReportTarget:
      properties:
        type:
          type: string
          const: atlas_report
          title: Type
        investigation_id:
          type: string
          maxLength: 200
          minLength: 1
          pattern: ^[A-Za-z0-9._-]+$
          title: Investigation Id
          description: The Atlas investigation whose report a reader flagged.
      additionalProperties: false
      type: object
      required:
        - type
        - investigation_id
      title: AtlasReportTarget
    FieldVerdict:
      properties:
        path:
          type: string
          maxLength: 200
          minLength: 1
          title: Path
          description: >-
            The literal top-level key of `structured_data`, a response field
            such as `email`, or a column of the results file. Dots and brackets
            are part of the key, not a path into nested values.
        verdict:
          type: string
          enum:
            - correct
            - wrong
            - outdated
            - missed
          title: Verdict
          description: >-
            `correct`, `wrong`, `outdated` (right once, not now) or `missed` (we
            returned nothing, but a value exists). A field you leave out counts
            as not reviewed.
        returned:
          $ref: '#/components/schemas/JsonValue'
          description: >-
            What we returned for the field, as you saw it. Default: none; we
            keep our own copy.
        correct:
          $ref: '#/components/schemas/JsonValue'
          description: >-
            The right value, when you know it. Not with the `correct` verdict.
            Default: none.
        evidence_urls:
          items:
            type: string
            maxLength: 2048
            minLength: 1
          type: array
          maxItems: 5
          title: Evidence Urls
          description: >-
            Up to 5 public `http` or `https` URLs that show the right value.
            Default: none.
        note:
          anyOf:
            - type: string
              maxLength: 2000
              minLength: 1
            - type: 'null'
          title: Note
          description: 'Anything else about this field. Default: none.'
      additionalProperties: false
      type: object
      required:
        - path
        - verdict
      title: FieldVerdict
    FeedbackSource:
      properties:
        kind:
          anyOf:
            - type: string
              enum:
                - human
                - agent
                - automated
            - type: 'null'
          title: Kind
          description: >-
            Who wrote the feedback: a person, an AI agent, or an automated
            check. Default: none.
        agent_name:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
            - type: 'null'
          title: Agent Name
          description: 'The agent''s name, when an agent wrote it. Default: none.'
        model:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
            - type: 'null'
          title: Model
          description: >-
            The model the agent runs on, as its provider names it. Default:
            none.
        reviewer:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
              pattern: ^[A-Za-z0-9._:-]+$
            - type: 'null'
          title: Reviewer
          description: >-
            Your own id for the person or agent reviewing. Each reviewer's
            verdicts are kept apart, and a later verdict replaces only the same
            reviewer's earlier one. An opaque id, never a name or an email
            address: hash one if you must. Default: none.
      additionalProperties: false
      type: object
      title: FeedbackSource
    ResolvedTaskTarget:
      properties:
        type:
          type: string
          const: task
          title: Type
        task_id:
          type: string
          title: Task Id
          description: The task, with a `dispatch_id` resolved to its `task_id`.
      type: object
      required:
        - type
        - task_id
      title: ResolvedTaskTarget
    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: {}
    JsonValue: {}
  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.