---
title: "Submit a custom script execution request"
method: POST
path: "/v3/{ownerHash}/{capabilityName}"
tags: ["Custom Scripts"]
---

# Submit a custom script execution request

`POST /v3/{ownerHash}/{capabilityName}`

## Request

- Base URL: `https://illustrator-api.adobe.io`
- URL: `https://illustrator-api.adobe.io/v3/{ownerHash}/{capabilityName}`
- Auth: HTTP bearer and API key in header `x-api-key`

Submits execution requests for custom scripts. Defines input assets and parameters that the custom script will use during execution.

## Path parameters

- `ownerHash` string, required
- `capabilityName` string, required

## Request body

- CustomScriptExecuteRequest: This job request object specifies parameters for the execution of the custom script.
  - `assets` object[], required: Array of **Input assets**. Information about the assets, which will be used to process the job (for example AI documents, font archives, packaged assets, and so on).
    - `source` object, required: Presigned URL for the asset.
      - `url` string, required: Presigned URL pointing to the asset.
    - `destination` string, required: Local filename for the asset in the job workspace (referenced by `targetDocument` and other params). Path relative to the job workspace. Cannot contain `..`, a leading `/`, or `./`. Must be a valid filename.
  - `params` object
    - `targetDocument` string, required: Filename of the Illustrator document to process.
    - `outputFolderPath` string, required: Output folder path for generated files.
    - `zip` string: Optional. Destination filename of a zipped asset when inputs are packaged as a ZIP.
    - `fontFolderPath` string: Optional. Relative path to a font folder when required by the script. Path relative to the job workspace. Cannot contain `..`, a leading `/`, or `./`. Must be a valid filename. To use this parameter, the `zip` parameter must also be provided.

## Response `202`

Accepted

- CustomScriptExecuteResponse: Returned when a Custom Scripts execution request is accepted (HTTP 202).
  - `jobId` string, required: Job identifier. Use with **Retrieve job status** on `GET /v3/status/{jobId}` for Custom Scripts jobs.
  - `statusUrl` string, required: URL to poll for job status.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Requested Resource Was Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-29** `62ba1bac5f86`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adobe/apis/illustrator-api-firefly-services/changes/v3/:ownerHash/:capabilityName/post.md)

---

[API](https://skmtc.dev/adobe/apis/illustrator-api-firefly-services.md) - [All operations](https://skmtc.dev/adobe/apis/illustrator-api-firefly-services/llms.txt) - [OpenAPI document](https://skmtc.dev/adobe/apis/illustrator-api-firefly-services/revisions/62ba1bac5f86?raw)