Agent Feedback

Submit agent feedback

Changed on

Report an API issue or documentation mismatch, including request IDs when available.

post/feedback

Request

  • Base URL: https://api.context.dev/v1
  • URL: https://api.context.dev/v1/feedback
  • Auth: HTTP bearer

Request body

request_idstring uuid

The request_id of the API call the feedback is about, from its response body or X-Request-Id header.

category'bug' | 'docs_mismatch' | 'friction' | 'feature_gap' | 'quality_degradation' | 'other' required

Kind of issue.

notestring required

What went wrong and what you expected instead.

urlstring uri

The page the feedback is about, such as one page of a crawl or a docs page.

tagsstring[]

Labels for filtering usage in the dashboard.

Example request

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "note": "Markdown drops the plan comparison table; expected all 4 rows.",
  "url": "https://stripe.com/pricing",
  "tags": [
    "production",
    "team-alpha"
  ]
}

Response

Feedback for this request_id was already recorded

feedback_idstring required

ID of the stored feedback.

already_submittedboolean required

True when feedback for this request_id was already recorded; the original feedback_id is returned.

request_idstring uuid required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

Example response

{
  "feedback_id": "fb_8f14e45fceea167a5a36dedd4bea2543",
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"
}

Changes

  • 61627728926bRevision changes
    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

    • warning

      added the new NO_PUBLISHED_MARKDOWN enum value to the response property for the response status

  • 4ddcf49b9fe5Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status