---
title: "Executes an ability for multiple delegators in batch"
method: POST
path: "/app/{abilityName}/execute"
tags: ["App", "Ability"]
---

# Executes an ability for multiple delegators in batch

`POST /app/{abilityName}/execute`

Executes a Vincent ability for multiple delegators using a shared delegatee private key. Each delegator can have custom parameters that override the defaults. The delegatee app ID is automatically looked up from the private key.

## Path parameters

- `abilityName` string, required

## Request body

- ExecuteBatchAbilityRequest
  - `delegateePrivateKey` string, required — Private key of the delegatee (app PKP). Used to derive the app ID automatically.
  - `defaults` object — Default parameters for the ability execution that apply to all delegators unless overridden
  - `delegators` BatchDelegator[], required — Array of delegators to execute the ability for
    - `delegatorAddress` string, required — Ethereum address of the delegator (user who delegated ability to the app)
    - `abilityParams` object, required — Ability-specific parameters for this delegator, which override the defaults

## Response `200`

Batch execution completed (some delegators may have failed, check individual results)

- ExecuteBatchAbilityResponse
  - `results` object, required — Map of delegator addresses to their execution results

## Other responses

- `400` — Invalid input (missing required fields or invalid delegators array)
- `500` — Server error (ability not supported, app not found, etc.)
- `default` — Unexpected error

---

[API](https://skmtc.dev/lit-protocol/apis/vincent-registry-api.md) · [All operations](https://skmtc.dev/lit-protocol/apis/vincent-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lit-protocol/vincent-registry-api/revisions/825608de85fb/schema)