Create an agent run

curl --request POST \
  --url https://www.fluenterp.com/api/v1/agents/{agent_id}/run \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "files": [
    {
      "file_key": "agents/example/invoice.pdf",
      "file_name": "invoice.pdf",
      "content_type": "application/pdf"
    }
  ],
  "process_together": false
}
'

{
  "data": {
    "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workflow_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "queued",
    "status_url": "<string>",
    "message": "<string>"
  }
}

{
  "detail": "Agent not found",
  "status": 404
}

{
  "detail": "Agent not found",
  "status": 404
}

{
  "detail": "Agent not found",
  "status": 404
}

{
  "detail": "Agent not found",
  "status": 404
}

{
  "detail": "Agent not found",
  "status": 404
}

POST

api

agents

{agent_id}

run

curl --request POST \
  --url https://www.fluenterp.com/api/v1/agents/{agent_id}/run \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "files": [
    {
      "file_key": "agents/example/invoice.pdf",
      "file_name": "invoice.pdf",
      "content_type": "application/pdf"
    }
  ],
  "process_together": false
}
'

{
  "data": {
    "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workflow_run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "queued",
    "status_url": "<string>",
    "message": "<string>"
  }
}

{
  "detail": "Agent not found",
  "status": 404
}

{
  "detail": "Agent not found",
  "status": 404
}

{
  "detail": "Agent not found",
  "status": 404
}

{
  "detail": "Agent not found",
  "status": 404
}

{
  "detail": "Agent not found",
  "status": 404
}

Authorizations

X-API-Key

string

header

required

A Fluent API key beginning with fl-.

Path Parameters

agent_id

string<uuid>

required

Fluent agent ID.

Body

application/json

Option 1
Option 2

files

object[]

required

Required array length: 1 - 50 elements

Show child attributes

user_message

string

Instruction or text input for the agent.

process_together

boolean

default:false

Process foreground files in one agent conversation.

notification_email

string<email>

Email to notify when processing finishes.

background_files

object[]

Files available to tools but not read directly by the agent.

Maximum array length: 10

Show child attributes

Response

Run queued

data

object

required

Show child attributes

Overview

Discovery

Agents

Connections

Data

Utilities

Model Context Protocol

Create an agent run

Authorizations

Path Parameters

Body

Response