Skip to main content

Skip Clearance Suggestions

POST 

/api/v2/clearance-plans/:clearancePlan/suggestions/skip

Skip markdown suggestions. Prices stay unchanged and a skipped step is not suggested again for that product; the next step can still become due.

Required scope: products:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body:

  • suggestion_ids (required, array of 1–5000 distinct integer suggestion ids): only pending or held suggestions of this plan are skipped.
  • reason (optional, string, max 255): stored as the suggestion's held_reason (default "Skipped").

Response: data.skipped (how many were skipped) and message.

Requires a Bearer token with the products read/write scope and the products.manage_pricing permission.

Request​

Responses​

OK

Response Headers
    Content-Type