Delete export

DELETE

/v1/exports/{id}

• Production

Delete an export and its associated S3 file. Exports that are pending or currently processing cannot be deleted. If the export transitions between states during the request, the server may return a transient 409 — retry the request in that case.

Authorizations

• BearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Export job identifier (UUIDv7)

Example

01935abc-def0-7123-4567-890abcdef012

Responses

204

Export deleted successfully

401

Unauthorized - Invalid or missing API key

object

error

object

code

Machine-readable error code

string

Example

INVALID_REQUEST

message

Human-readable error message

string

Example

endpoint must be a valid HTTPS URL

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Example

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}

404

Resource not found

object

error

object

code

Machine-readable error code

string

Example

INVALID_REQUEST

message

Human-readable error message

string

Example

endpoint must be a valid HTTPS URL

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Example

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Message not found"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}

409

Export is pending or in progress

object

error

object

code

Machine-readable error code

string

Example

INVALID_REQUEST

message

Human-readable error message

string

Example

endpoint must be a valid HTTPS URL

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Example

{
  "error": {
    "code": "EXPORT_ACTIVE",
    "message": "Cannot delete an export that is pending or in progress. Please try again in a moment."
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}