FruxonDocs
AgentsCore

Updates an existing agent

Patches top-level agent metadata (display name, description, etc.). This does not touch the flow definition or any revision — to change the executable behavior, edit the draft revision and redeploy. The update is applied to the live agent record immediately and is visible to all collaborators on the next read. Returns 404 if the agent has been deleted or is still in the deletion grace period from another caller.

PUT
/v1/tenants/{tenant}/agents/{agent}

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 to update.

tenant*string

The tenant identifier

Request Body

The agent update request.

displayName?string|null
description?string|null
avatarFileId?string|null
type?string
Value in"UNSPECIFIED" | "SUMMARIZATION" | "RECOMMENDATION" | "ANALYZER" | "CHAT" | "OTHER"
tags?|null
externalConfig?

Updated remote-platform configuration. Only applied when the agent is non-native. Origin itself is intentionally immutable post-creation — switching native ↔ external would invalidate revisions and traces, so the caller must delete and recreate.

redactLlmMessages?boolean|null

Per-agent prompt/completion redaction toggle. Nullable so the partial-update payload can leave it untouched; only flipped when the caller explicitly sends a value.

[key: string]?never

Response Body

curl -X PUT "https://api.fruxon.com/v1/tenants/string/agents/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "displayName": "string",
  "description": "string",
  "avatarFileId": "string",
  "tags": [
    "string"
  ],
  "type": "SUMMARIZATION",
  "enabled": false,
  "enabledBeforeDeletion": false,
  "currentRevision": 0,
  "shape": "AGENT",
  "runnableType": "AGENT",
  "createdAt": 0,
  "modifiedAt": 0,
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "networkId": "00000000-0000-0000-0000-000000000000",
  "solutionId": "string",
  "deletedAt": 0,
  "evaluationMetrics": [
    {
      "metricId": "00000000-0000-0000-0000-000000000000",
      "weight": 0
    }
  ],
  "origin": "NATIVE",
  "externalConfig": {
    "parameters": {}
  },
  "externalConfigHints": {},
  "redactLlmMessages": false
}
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "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.