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

> Tells Sixtyfour a result was right or wrong: a rating, a comment, or corrected field values.

Send at least one of `comment`, `rating` or `corrections`. Name the Job with `job_id` so the feedback
reaches the result it is about. Free.



## OpenAPI

````yaml /openapi.json post /v1/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:
  /v1/feedback:
    post:
      tags:
        - Feedback V1
      summary: Send Feedback
      description: >-
        Tells Sixtyfour a result was right or wrong: a rating, a comment, or
        corrected field values.


        Send at least one of `comment`, `rating` or `corrections`. Name the Job
        with `job_id` so the feedback

        reaches the result it is about. Free.
      operationId: send_feedback_v1_feedback_post
      parameters:
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 1
                maxLength: 255
              - type: 'null'
            description: >-
              Reuse to retry the same body safely. A different body with this
              key fails with `idempotency_key_reused`.
            title: Idempotency-Key
          description: >-
            Reuse to retry the same body safely. A different body with this key
            fails with `idempotency_key_reused`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendFeedback'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/api__routers__v1_feedback_api__FeedbackReceipt
        '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
        '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:
    SendFeedback:
      properties:
        comment:
          anyOf:
            - type: string
              maxLength: 2000
              minLength: 1
            - type: 'null'
          title: Comment
          description: 'What happened, in your own words. Default: none.'
        rating:
          anyOf:
            - type: string
              enum:
                - positive
                - negative
            - type: 'null'
          title: Rating
          description: '`positive` or `negative`. Default: none.'
        corrections:
          items:
            $ref: '#/components/schemas/Correction'
          type: array
          maxItems: 200
          title: Corrections
          description: >-
            Fields that were wrong, outdated, or missed, up to 200. 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: >-
            One of `incorrect_data`, `outdated_data`, `missing_data`,
            `wrong_match`, `error`, `slow`, `confusing`, `missing_feature`,
            `billing`, `privacy`, or `other`. Default: none.
        impact:
          anyOf:
            - type: string
              enum:
                - blocked
                - worked_around
                - minor
            - type: 'null'
          title: Impact
          description: '`blocked`, `worked_around`, or `minor`. Default: none.'
        job_id:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
              pattern: ^[A-Za-z0-9._-]+$
            - type: 'null'
          title: Job Id
          description: >-
            The Job this feedback is about. Required with `corrections`. Omit
            for general feedback.
        goal:
          anyOf:
            - type: string
              maxLength: 2000
              minLength: 1
            - type: 'null'
          title: Goal
          description: 'What you were trying to do. Default: none.'
        operation:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
            - type: 'null'
          title: Operation
          description: >-
            The endpoint or tool, such as `POST /v1/people/contacts`. Default:
            none.
        source:
          anyOf:
            - $ref: '#/components/schemas/FeedbackSource'
            - type: 'null'
          description: 'Who wrote it. Default: none.'
        reply_to:
          anyOf:
            - type: string
              maxLength: 320
              format: email
            - type: 'null'
          title: Reply To
          description: 'An email address where Sixtyfour may reply. Default: none.'
      additionalProperties: false
      type: object
      title: SendFeedback
      examples:
        - comment: The email bounces. Her LinkedIn shows she left Acme in March.
          corrections:
            - field: email
              returned: jane@acme.com
              source_url: https://www.linkedin.com/in/janedoe
              value: jane@newco.com
          job_id: job_7d1c0e52-5b8f-4c1a-9f0e-3a2b1c4d5e6f
          rating: negative
    api__routers__v1_feedback_api__FeedbackReceipt:
      properties:
        feedback_id:
          type: string
          title: Feedback Id
          description: Feedback ID.
        already_submitted:
          type: boolean
          title: Already Submitted
          description: >-
            If true, this `Idempotency-Key` was already used and nothing new was
            saved.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: When the feedback was saved.
        corrections_recorded:
          type: integer
          title: Corrections Recorded
          description: Number of corrections saved.
        job_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Job Id
          description: The Job this feedback is about. Null for general feedback.
      type: object
      required:
        - feedback_id
        - already_submitted
        - created_at
        - corrections_recorded
      title: FeedbackReceipt
      examples:
        - already_submitted: false
          corrections_recorded: 1
          created_at: '2026-05-01T12:00:00Z'
          feedback_id: 6a0b5d0e-8f1e-4c2a-b7d3-9e8f7a6b5c4d
          job_id: job_7d1c0e52-5b8f-4c1a-9f0e-3a2b1c4d5e6f
    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
    Correction:
      properties:
        field:
          type: string
          maxLength: 200
          minLength: 1
          title: Field
          description: The result key or workflow column, such as `email`.
        value:
          $ref: '#/components/schemas/JsonValue'
          description: The right value, as JSON. `null` means the field should be empty.
        kind:
          type: string
          enum:
            - wrong
            - outdated
            - missed
          title: Kind
          description: '`wrong`, `outdated`, or `missed`. Default: `wrong`.'
          default: wrong
        returned:
          $ref: '#/components/schemas/JsonValue'
          description: 'What we returned for the field, as you saw it. Default: none.'
        source_url:
          anyOf:
            - type: string
              maxLength: 2048
              minLength: 1
            - type: 'null'
          title: Source Url
          description: >-
            A public `http` or `https` page that shows the right value. Default:
            none.
      additionalProperties: false
      type: object
      required:
        - field
        - value
      title: Correction
    FeedbackSource:
      properties:
        kind:
          anyOf:
            - type: string
              enum:
                - human
                - agent
                - automated
            - type: 'null'
          title: Kind
          description: '`human`, `agent`, or `automated`. Default: none.'
        agent_name:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
            - type: 'null'
          title: Agent Name
          description: 'The agent''s name. Default: none.'
        model:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
            - type: 'null'
          title: Model
          description: 'The model the agent runs on. Default: none.'
        reviewer:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
              pattern: ^[A-Za-z0-9._:-]+$
            - type: 'null'
          title: Reviewer
          description: >-
            Your opaque id for the reviewer, never a name or email. Default:
            none.
      additionalProperties: false
      type: object
      title: FeedbackSource
    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
    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.