Retrieves a specific agent revision.
Returns the immutable snapshot of an agent's configuration at the given revision number, including the flow graph (nodes, edges, prompts, tool bindings), the input parameter schema, and the revision's deployment status. The revision identifier may be a numeric version, or pass `draft` to inspect the in-progress unsaved revision being edited. Deployed revisions are read-only; use the create-agent-revisions endpoints to fork a new draft and deploy it with `POST .../revisions/{revision}:deploy`.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The unique identifier of the agent.
The revision identifier.
The tenant identifier
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/revisions/string"{
"agentId": "string",
"agentRevision": 0,
"comment": "string",
"parametersMetadata": [
{
"name": "string",
"index": 0,
"type": "String",
"typeName": "string",
"integerRange": {
"min": 0,
"max": 0
},
"floatRange": {
"min": 0,
"max": 0
},
"options": [],
"asset": {
"providers": null,
"contentTypes": null,
"vectorized": false
},
"displayName": "string",
"description": "string",
"required": false,
"secret": false,
"defaultValue": "string",
"jsonSchema": null,
"uiHint": "CODE",
"rules": []
}
],
"subAgents": [
{
"id": "string",
"slug": "string",
"integrationId": "sub_agent",
"agentId": "string",
"displayName": "string",
"description": "string",
"toolType": "AGENT_TOOL",
"actionType": "READ_ONLY",
"resultType": "STRING",
"authSettings": {
"supportsOAuth": false,
"oAuth": []
},
"flow": {
"steps": [],
"edges": []
},
"parametersMetadata": [],
"avatarFileId": "string"
}
],
"flow": {
"steps": [],
"edges": [
{
"source": "string",
"target": "string"
}
]
},
"connectors": [
{
"name": "string",
"provider": "string",
"active": false,
"policy": "ALLOW_ALL",
"onBoardingMessage": "string",
"environmentSlug": "string",
"agentId": "string",
"agentRevision": 0,
"parameters": {},
"apiKeyId": "00000000-0000-0000-0000-000000000000",
"createdAt": 0,
"id": "00000000-0000-0000-0000-000000000000",
"modifiedAt": 0
}
],
"integrationConfigs": [
{
"id": "00000000-0000-0000-0000-000000000000",
"integrationId": "string",
"displayName": "string",
"parameters": {},
"auth": {
"integrationAuthMetadataId": "string",
"level": "UNSPECIFIED",
"parameters": null
},
"authMap": [],
"sandboxMode": "NONE",
"sandboxVariant": {
"parameters": {},
"auth": {
"integrationAuthMetadataId": null,
"level": "USER",
"parameters": {}
},
"authMap": []
},
"tenantConfigId": "00000000-0000-0000-0000-000000000000"
}
],
"integrationBindings": {},
"llmConfigs": [
{
"providerId": "string",
"parameters": {},
"tenantConfigId": "00000000-0000-0000-0000-000000000000"
}
],
"assets": [
{
"id": "string",
"displayName": "string",
"sourceType": "string",
"vectorized": true,
"ragAssetId": "00000000-0000-0000-0000-000000000000",
"assetLink": "string"
}
],
"jobPolicyConfigs": [
{
"id": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000",
"createdAt": 0,
"modifiedAt": 0,
"agentId": "string",
"agentRevision": 0,
"scheduleFrequency": "DAILY",
"scheduleDay": "sunday",
"scheduleDayOfMonth": "_1",
"scheduleHour": "string",
"scheduleMinute": "string",
"intervalValue": 0,
"intervalUnit": "MINUTES",
"timezone": "string",
"timeout": 0,
"prompt": "string"
}
],
"createdBy": "string",
"actor": "string",
"createdAt": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Returns the deploy audit history for an agent.
Each row records a deploy attempt (successful or failed), the previous and target revision, the user who triggered it, the per-connector activation results, and the time of the deploy. Rows are ordered newest first.
Gets aggregated per-model token usage for a specific agent revision or all revisions.
Returns one row per `(provider, model)` pair seen in this revision's executions, summing input tokens, output tokens, and call counts so callers can rank model spend and detect drift after a revision change. Pass `*` as the revision to aggregate across every revision the agent has ever run, which is useful for top-of-funnel dashboards; pass a specific revision number to attribute usage to one deployed version. Pair with the revision cost endpoints for dollar-cost breakdowns rather than raw tokens.