Delete export

DELETE

/v1/exports/{id}

curl --request DELETE \
  --url https://api.hookbridge.io/v1/exports/01935abc-def0-7123-4567-890abcdef012 \
  --header 'Authorization: Bearer <token>'

• 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

Media typeapplication/json

object

error

object

code

Machine-readable error code

string

message

Human-readable error message

string

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

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

404

Resource not found

Media typeapplication/json

object

error

object

code

Machine-readable error code

string

message

Human-readable error message

string

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

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

409

Export is pending or in progress

Media typeapplication/json

object

error

object

code

Machine-readable error code

string

message

Human-readable error message

string

meta

object

request_id

Unique identifier for this request (useful for support)

string

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"
  }
}