FruxonDocs
AgentsCore

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

GET
/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 read.

tenant*string

The tenant identifier

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/agents/string"
{
  "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
    }
  ],
  "evaluationProvider": {
    "providerId": "string",
    "model": "string",
    "parameters": {},
    "fallbacks": [
      {
        "providerId": "string",
        "model": "string",
        "tenantConfigId": null
      }
    ],
    "builtInTools": [
      {
        "toolKey": null,
        "integrationConfigId": null,
        "integrationConfig": null,
        "humanApproval": null,
        "repeatGuard": null,
        "durableEffect": null,
        "pinnedParameters": null
      }
    ],
    "tenantConfigId": "00000000-0000-0000-0000-000000000000"
  },
  "origin": "NATIVE",
  "externalConfig": {
    "parameters": {}
  },
  "externalConfigHints": {},
  "managedBy": {
    "ownerKind": "KNOWLEDGE_SOURCE",
    "ownerId": "00000000-0000-0000-0000-000000000000",
    "roles": [
      "SOURCE"
    ],
    "ownership": "MANAGED",
    "ownerDisplayName": "string",
    "ownerContainerId": "00000000-0000-0000-0000-000000000000",
    "ownerContainerDisplayName": "string",
    "linkedOwnerCount": 0
  },
  "redactLlmMessages": false
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Updates an Agent through its canonical owning Application.

Updates the Agent's top-level metadata only — its definition 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.

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.