Wingfield Logo
Wingfield Partner API
Booking

Delete court booking

DELETE
/api/v1/external-services/{externalServiceId}/court-bookings/by-external-id/{externalCourtBookingId}

Delete a court booking by external booking ID. Missing bookings are treated as successfully deleted, making this endpoint idempotent.

Required Scopes:
court-bookingwrite

Path Parameters

externalServiceId*string

External service identifier.

Formatuuid
externalCourtBookingId*string

External booking identifier in your system.

Length1 <= length

Query Parameters

externalUpdatedAt*string

Last update timestamp from your system.

Formatdate-time

Error Responses

400

invalid_schema

Request validation failed.

401

missing_api_token

No authentication token provided.

401

invalid_api_token

Invalid or expired authentication token.

403

scope_permission_denied

Insufficient permissions for this operation.

403

external_service_access_denied

Token does not match the requested external service.

403

organization_access_denied

Service is not granted access to the organization.

404

court_not_found

Court was not found.

409

stale_write

Request is older than the stored resource version.

curl -X DELETE "https://dev.wingfield.systems/api/v1/external-services/497f6eca-6276-4993-bfeb-53cbbbba6f08/court-bookings/by-external-id/string?externalUpdatedAt=2019-08-24T14%3A15%3A22Z"
{}
{
  "error": {
    "type": "invalid_schema",
    "message": "string",
    "issues": [
      {}
    ]
  }
}
{
  "error": {
    "type": "missing_api_token",
    "message": "string"
  }
}
{
  "error": {
    "type": "scope_permission_denied",
    "message": "string"
  }
}
{
  "error": {
    "type": "court_not_found",
    "message": "string"
  }
}
{
  "error": {
    "type": "stale_write",
    "message": "string"
  }
}