FruxonDocs
AgentsRevisions

Lists an agent's revisions, newest first.

One summary per revision: its number, comment, author (`createdBy`, plus the authoring tool as `actor`) and creation time; `isCurrent` on the revision executions run; and `lastDeployedAt`, the last successful deploy that made it current according to `GET .../revisions/deploys` (null for a first revision, which goes live at creation without a deploy). Definitions are not included — fetch one with `GET .../revisions/{revision}`. The unsaved draft is not a revision and is never listed. Paged; `totalCount` is always set.

GET
/v1/tenants/{tenant}/agents/{agent}/revisions

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The unique identifier of the agent.

tenant*string

The tenant identifier

Query Parameters

PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/revisions"
{
  "items": [
    {
      "agentId": "string",
      "agentRevision": 0,
      "comment": "string",
      "createdBy": "string",
      "actor": "string",
      "createdAt": 0,
      "isCurrent": false,
      "lastDeployedAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Gets an Agent through its canonical owning Application.

Returns the Agent's top-level metadata (display name, description, enabled flag, current deployed revision, deletion state). The lookup is scoped to the Application in the route, so an Agent owned by a different Application returns 404 even when the caller could reach it through `GET /v1/tenants/{tenant}/agents/{agent}`.

Gets aggregated cost for a specific agent revision or all revisions.

Returns cost information including total input/output costs, token usage, and execution count. Use `*` as the revision parameter to aggregate costs across all revisions.