v53

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-076771,7565.2 MB

agent builder

Get agent consumption data

Spaces method and path for this operation:

<div><span class="operation-verb post">post</span> <span class="operation-path">/s/{space_id}/api/agent_builder/agents/{agent_id}/consumption</span></div>

Refer to Spaces for more information.

Returns paginated, per-conversation token consumption data for a given agent. Includes input/output token counts, round counts, LLM call counts, and warnings for conversations with high token usage. Requires the manageAgents privilege. To learn more about monitoring agent token usage, refer to the monitor usage documentation.<br/><br/>[Required authorization] Route required privileges: agentBuilder:manageAgents.

post/api/agent_builder/agents/{agent_id}/consumption

Path parameters

agent_idstring required

The unique identifier of the agent.

Headers

kbn-xsrfstring required

Example:true

A required header to protect against CSRF attacks

Request body

has_warningsboolean

Filter to conversations with or without high-token warnings.

searchstring

Free-text search filter on conversation title.

sizenumber

Number of results per page.

sort_field'updated_at' | 'total_tokens' | 'round_count'

Field to sort results by.

sort_order'asc' | 'desc'

Sort direction.

usernamesstring[]

Filter results to conversations by these usernames.

Response

Indicates a successful response