---
title: "Run agent"
method: POST
path: "/api/1/agent/executions"
tags: ["Executions"]
---

# Run agent

`POST /api/1/agent/executions`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/1/agent/executions`
- Auth: HTTP bearer

Runs one or more agents on assets. Send one item per agent, each with the asset list to process. The request is accepted as a whole: agents that could not be started are listed in `error` in the response, with the reason, and the ones that did start are listed in `success`.

## Request body

- ExecutionRequestItem[]: An array of per-agent run requests, not a single object. Each item must include its own `agentId`.
  - `agentId` string, uuid, required
  - `assetIds` string[], required
  - `agentExecutionName` string
  - `workspaceBatchId` string, uuid, nullable

## Response `202`

Execution(s) accepted for processing. The response lists the executions that were created, the requests that failed, and a summary.

- ExecutionResult: The outcome of a run request.
  - `success` object[]: The executions that were created.
    - `agentId` string
    - `name` string
    - `agentExecutionId` string, uuid
    - `capabilities` string[]
  - `error` object[]: The run requests that failed.
    - `agentId` string
    - `name` string, nullable
    - `capabilities` string[], nullable
    - `errorType` string
  - `executionSummary` object: Counts of run requests by outcome.

## Other responses

- `400`: The request body failed validation
- `401`: Missing or invalid bearer token
- `403`: Caller lacks the required permission for this operation
- `429`: Caller exceeded its configured request rate
- `5XX`: Gateway or a downstream service failed to process the request

---

[API](https://skmtc.dev/bynder/apis/ai-agents.md) - [All operations](https://skmtc.dev/bynder/apis/ai-agents/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/ai-agents/revisions/60a586064d6f?raw)