FruxonDocs
AgentsCore

Lists the Agents canonically owned by an Application.

Returns only the Agents whose canonical owner is the Application in the route — unlike `GET /v1/tenants/{tenant}/agents`, which spans every Application the caller can reach. The response is cursor-paginated and the caller needs at least the Viewer role on the Application. Returns 404 if the Application does not exist or is not accessible.

GET
/v1/tenants/{tenant}/networks/{network}/agents

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
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 pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.

query?string

Optional case-insensitive substring filter matched against the Agent id, display name, and description. Omit for the unfiltered list.

tags?array<string>

Optional tag filter (repeatable). Agents carrying any of the supplied tags match. Use GET .../agents/facets to discover the available tags.

shape?string

Optional shape filter. Narrows to Agents whose current deployed revision has that structural Agents.FlowShape. Omit for all shapes.

Value in"UNSPECIFIED" | "AGENT" | "WORKFLOW" | "TOOL_ONLY" | "EMPTY" | "INVALID"
managed?string

Optional managed-ownership filter. EXCLUDE returns only Agents no packaged product manages; ONLY returns only the Agents one does. Omit (or ANY) for both. Read each Agent's managedBy for the owner, and GET .../agents/facets for the managed total.

Default"ANY"
Value in"UNSPECIFIED" | "ANY" | "EXCLUDE" | "ONLY"

Response Body

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

Deletes an agent

Soft-deletes the agent: it is disabled immediately so no further executions are accepted, all running executions are abandoned, and a background purge job removes underlying data (revisions, execution history, traces, collaborator grants) after a grace period. During the grace window the deletion can be reversed with `POST /v1/tenants/{tenant}/agents/{agent}:cancelDelete`; once the purge runs the agent ID is unrecoverable. Returns 204 on success and is idempotent against an already-deleted agent (returns 404).

Deletes an Agent through its canonical owning Application.

Soft-deletes the Agent — it stops serving traffic but stays readable within the deletion grace period before it is purged. The lookup is scoped to the Application in the route, so an Agent owned by a different Application returns 404. Requires the Admin role.