Get Edit Run

Retrieve the status and results of an edit run.

Use this endpoint to get results for an edit run that has already completed, or to check on the status of an asynchronous edit run initiated via the Edit File Asynchronously endpoint.

If editing is still in progress, you’ll receive a response with just the status. Once complete, you’ll receive the full edited file information in the response.

Retrieve the status and results of an edit run. Use this endpoint to get results for an edit run that has already completed, or to check on the status of an asynchronous edit run initiated via the [Edit File Asynchronously](/developers/api-reference/edit-endpoints/edit-file-async) endpoint. If editing is still in progress, you'll receive a response with just the status. Once complete, you'll receive the full edited file information in the response.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

The unique identifier for the edit run.

Example: "edit_run_xK9mLPqRtN3vS8wF5hB2cQ"

Response

Successfully retrieved edit run

successboolean

editRunobject

warningstring or null

Warning message about missing API version header if applicable

1	{
2	"success": true,
3	"editRun": {
4	"object": "edit_run_status",
5	"id": "edit_run_xK9mLPqRtN3vS8wF5hB2cQ",
6	"status": "PROCESSING",
7	"failureReason": "string"
8	},
9	"warning": "string"
10	}

Authentication

Path parameters

Headers

Response

Errors