List feedback for an agent

Lists feedback submitted across all objectives belonging to an agent. Supports search by comment, sentiment filter, agent variation filter, and creation date range. Results are ordered by creation time, newest first.

get/v1/workspaces/{workspaceId}/agents/{agentId}/feedback

Path parameters

workspaceIdstring required

Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q

agentIdstring required

Example:agent_01HXKD2E5NQM3T9AYWCFMGWT9Y

The ID of the agent. Supports "external_id:" prefix for external IDs.

Query parameters

limitinteger

Maximum number of results to return.

cursorstring

Pagination cursor from previous response.

querystring

Free-text search applied to the feedback comment. Case-insensitive substring match.

sentiment'FEEDBACK_SENTIMENT_UNSPECIFIED' | 'FEEDBACK_SENTIMENT_POSITIVE' | 'FEEDBACK_SENTIMENT_NEGATIVE' enum

Filter by sentiment. UNSPECIFIED returns feedback regardless of score.

agentVariationIdstring

Optional filter to limit results to feedback on objectives run by a single agent variation. Supports "external_id:" prefix for external IDs.

createdAfterstring date-time

Inclusive lower bound on feedback creation time.

createdBeforestring date-time

Exclusive upper bound on feedback creation time.

labelsstring

Filters by metadata labels. Comma-separated key=value pairs, e.g. "env=prod,team=ai". A resource matches only if every pair matches exactly (AND semantics).

includeInfoboolean

When set to true you may use more of your alloted API rate-limit

Response

Example response

{
  "items": [
    {
      "metadata": {
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
      },
      "info": {
        "submittedBy": {
          "metadata": {
            "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
            "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08"
          }
        }
      }
    }
  ]
}

Changes

Changed in 4 of the 57 revisions of this API.22

Jul 8, 2026a99a473ee3ad1See the full diff
- ●
  removed the optional property pagination/total from the response with the 200 status
  response-optional-property-removed
Jul 8, 2026e72f368ddab71See the full diff
- ○
  added the new optional query request parameter labels
  new-optional-request-parameter
Jul 2, 202606e0e37c14991See the full diff
- ○
  added the optional property items/items/info/submittedBy/allOf[Profile]/metadata/createdAt to the response with the 200 status
  response-optional-property-added
This revision also has 27 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 5, 20260702cb021b661See the full diff
- ●
  added the new PROFILE_TYPE_UNSPECIFIED enum value to the items/items/info/submittedBy/allOf[Profile]/spec/type response property for the response status 200
  response-property-enum-value-added

Full history