FruxonDocs
AgentsCore

Updates an Agent through its canonical owning Application.

Updates the Agent's top-level metadata only — the flow graph is versioned separately through the revisions endpoints. The lookup is scoped to the Application in the route, so an Agent owned by a different Application returns 404. Requires the Editor role.

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

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

network*string

Id of the owning Application.

Formatuuid
agent*string

Id of the Agent to update.

tenant*string

The tenant identifier

Request Body

The fields to change. Omitted fields are left untouched.

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/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/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
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Creates an Agent canonically owned by the Application in the route.

The Application in the route wins — any owner supplied in the body is overwritten before validation, so an Agent can never be created into a different Application than the one the caller was authorized against. Requires the Editor role. Responds 201 with a `Location` header pointing at the new Agent, or 400 with per-field validation errors.

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}`.