Sign in

v56

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01142337440.5 KB
AgentService
Agents

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

OK

Example response

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