usage

List Fleet agent costs

Changed on

Returns the same agent cost report as the Fleet usage UI. Costs are estimates in USD from recorded traces, not invoice totals. Requires fleet:read-admin-config. Keep the time window and sorting unchanged across pages. Results are live: late traces or cost updates can move rows between pages; pagination does not provide a frozen snapshot.

get/v1/fleet/usage/agents

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/v1/fleet/usage/agents
  • Auth
    • API key in header X-API-Key and API key in header X-Tenant-Id
    • or HTTP bearer and API key in header X-Tenant-Id

Query parameters

page_sizeinteger

Items per page (1-100, default 20)

cursorstring

Opaque cursor from the previous response; omit for the first page

start_timestring date-time required

Start of cost window (RFC 3339)

end_timestring date-time required

End of cost window (RFC 3339)

sort_by'cost' | 'runs' | 'last_used' | 'first_used'

Sort field

sort_order'asc' | 'desc'

Sort direction

Response

OK

next_cursorstring nullable required

Changes

  • c141773e30b5Revision changes
    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • info

      added the required property // to the response with the status

  • ec156df8da3aRevision changes
    • info

      endpoint added