Create protest

POST 
/v1/protests

Creates a protest for a charge. The record starts as pending and is ONLY sent to the notary after human review and approval (legal workflow; protest.review_required event). Returns 409 if an active protest (pending/sent/intimated/protested) already exists for the same charge.

Request

Responses

201

Protest created (awaiting human review).

400

Invalid request (validation error).

401

Missing, invalid, expired or revoked token.

403

The token lacks the scope required by this operation, or the organization has no active plan (ENTITLEMENT_REQUIRED, with details.reason = no_plan or missing_product).

404

Resource not found or outside your organization.

409

Conflict with the current resource state (or reused idempotency key).

413

Request body larger than 2 MB.

429

Rate limit exceeded (600 per minute per key; 60 invalid attempts per minute per IP). Wait for Retry-After.

500

Internal error. Retry; if it persists, contact support.