FruxonDocs
AgentsCore

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.

POST
/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 Application that will own the Agent.

Formatuuid
tenant*string

The tenant identifier

Request Body

The Agent definition. Its owning-Application field is ignored and replaced by the route value.

id*string
Length1 <= length
displayName?string
description?string
avatarFileId?string|null
type?string

Enum representing the different types of AI agents supported by Fruxon. Wire form is UPPER_SNAKE; Unspecified = 0 is the AIP-126 zero-sentinel.

This enum is mandatory, meaning every agent must have a specific type.

Value in"UNSPECIFIED" | "SUMMARIZATION" | "RECOMMENDATION" | "ANALYZER" | "CHAT" | "OTHER"
tags?array<string>
networkId?string

The Application selected to own this Agent at creation.

Formatuuid
origin?string

Where the agent's reasoning loop runs. Defaults to Fruxon.Model.Agents.External.AgentOrigin.Native. When set to a non-native value, Fruxon.Model.Agents.CreateAgent.ExternalConfig is required.

Value in"UNSPECIFIED" | "NATIVE" | "LANG_GRAPH" | "CREW_AI" | "OPEN_AI_ASSISTANTS" | "DIFY"
externalConfig?

Required when Fruxon.Model.Agents.CreateAgent.Origin is non-native. Holds the remote-platform connection details.

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/agents" \  -H "Content-Type: application/json" \  -d '{    "id": "string"  }'
{
  "id": "string",
  "displayName": "string",
  "description": "string",
  "avatarFileId": "string",
  "type": "SUMMARIZATION",
  "tags": [
    "string"
  ],
  "enabled": false,
  "currentRevision": 0,
  "createdAt": 0,
  "modifiedAt": 0,
  "origin": "NATIVE",
  "networkId": "00000000-0000-0000-0000-000000000000"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

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.

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.