FlintflintDocs

Delivery revocations

Delivery revocations are permanent emergency fences for delivery evidence that must no longer be trusted. Use one after a callback signing key compromise, a broken callback revision, an unsafe method revision, or a Location incident.

Archiving a configuration resource stops it from appearing in new quotes but does not invalidate evidence already issued. A revocation also rejects outstanding quotes and selections that depend on the target. This distinction is why revocations are separate from lifecycle transitions.

Revocations cannot be edited or deleted. Store the returned revocation ID and merchant note with the incident record that authorized the action.

Endpoints

Revoke delivery dependency#

POST/v1/delivery-revocationsIdempotentRequires scope: commerce.delivery.write

Permanently fences one exact method, endpoint, signing key, revision, or Location geography version and immediately revokes affected unowned quotes and provisional selections. Stable method and callback-endpoint targets require expected_version so a concurrent publication cannot broaden the revocation.

Request body
merchant_notestring
reasonenumrequired
unsafe_configurationlocation_unavailablecredential_compromiselegal_requirementother
targetone ofrequired

A typed revocation target. Each target_type accepts only its resource-specific identifiers and concurrency field.

Response · 201
dataobjectrequired
metaobject
request_idstring

Error codes

AUTH_REQUIREDDELIVERY_CONFIGURATION_INVALIDDELIVERY_DEPENDENCY_REVOKEDDELIVERY_RESOURCE_NOT_FOUNDDELIVERY_SERVICE_UNAVAILABLEINSUFFICIENT_SCOPEINVALID_REQUESTRATE_LIMIT_EXCEEDEDRESOURCE_NOT_FOUNDSERVICE_UNAVAILABLE
Bash
curl -X POST https://api.withflintpay.com/v1/delivery-revocations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: a-unique-key" \
  -d '{
    "reason": "unsafe_configuration",
    "target": {
      "location_geography_revision": 1,
      "location_id": "loc_01K1P6G4M7H2N8Q9R3S5T6V7WX",
      "target_type": "location_geography"
    }
  }'
JSON
{
  "data": {
    "created_at": "2026-08-02T16:00:00Z",
    "delivery_revocation_id": "example",
    "estimated_impact": {
      "active_quote_count": 1,
      "current_selection_count": 1
    },
    "reason": "unsafe_configuration",
    "target": {
      "location_geography_revision": 1,
      "location_id": "loc_01K1P6G4M7H2N8Q9R3S5T6V7WX",
      "target_type": "location_geography"
    }
  },
  "request_id": "req_01K1P6G4M7H2N8Q9R3S5T6V7WX"
}

Get delivery revocation#

GET/v1/delivery-revocations/{delivery_revocation_id}Requires scope: commerce.delivery.read or commerce.delivery.write

Returns one permanent delivery revocation and its estimated impact at creation time.

Path parameters
delivery_revocation_idstringrequired

Flint delivery revocation ID.

Response · 200
dataobjectrequired
metaobject
request_idstring

Error codes

AUTH_REQUIREDDELIVERY_CONFIGURATION_INVALIDDELIVERY_DEPENDENCY_REVOKEDDELIVERY_RESOURCE_NOT_FOUNDDELIVERY_SERVICE_UNAVAILABLEINSUFFICIENT_SCOPEINVALID_REQUESTRATE_LIMIT_EXCEEDEDRESOURCE_NOT_FOUNDSERVICE_UNAVAILABLE
Bash
curl https://api.withflintpay.com/v1/delivery-revocations/{delivery_revocation_id} \
  -H "Authorization: Bearer YOUR_API_KEY"
JSON
{
  "data": {
    "created_at": "2026-08-02T16:00:00Z",
    "delivery_revocation_id": "example",
    "estimated_impact": {
      "active_quote_count": 1,
      "current_selection_count": 1
    },
    "reason": "unsafe_configuration",
    "target": {
      "location_geography_revision": 1,
      "location_id": "loc_01K1P6G4M7H2N8Q9R3S5T6V7WX",
      "target_type": "location_geography"
    }
  },
  "request_id": "req_01K1P6G4M7H2N8Q9R3S5T6V7WX"
}
Rate this doc