Delete a paid membership

DELETE /program/memberships/{membership_id}


Scope	`program:write`
Customer session token	Not accepted: call from your server with an API key
Rate limit class	`write_shopify` (limits)
Idempotency key	Required (idempotency)
MCP tool	`charm_delete_membership`

Deletes a membership that is off sale and never had a member. The Shopify product stays. Call with dry_run: true first.

Parameters

Name	In	Type	Description
`membership_id`	path	string	The membership’s `id`.

Request body

Field	Type	Description
`dry_run`	boolean	Preview only: validate, resolve references and return the `diff` and `summary`, but write nothing. Costs no idempotency key and is limited as a read. Call with this first, show the merchant, then repeat without it. (optional)
`if_revision`	integer	The program `revision` you last read (from `GET /program` or a previous write). When the program changed since, the write is refused with `409 revision_conflict` instead of overwriting a concurrent admin edit. (optional)

Response `200`

Returns MembershipWriteResult.

Field	Type	Description
`dry_run`	boolean
`revision`	integer
`operation`	string: `create`, `update`, `delete`, `none`
`diff`	array of FieldChange
`summary`	string or null	(nullable)
`membership`	Membership
`product_created`	boolean	A new draft (unpublished) product was created in Shopify for this membership. (optional)
`would_create_product`	object	Dry run: the draft product a real call would create. (optional)
`product_status`	string	The product’s Shopify status when it is not ACTIVE (a DRAFT product cannot be bought until published). (optional)
`gating_republish_failed`	boolean	Saved, but the members-only content rules did not republish; save again to retry. (optional)

{
  "dry_run": false,
  "revision": 1,
  "operation": "create",
  "diff": [
    {
      "path": "path",
      "before": null,
      "after": null
    }
  ],
  "summary": "summary",
  "membership": {
    "id": "id",
    "name": "Gold",
    "name_translations": {},
    "enabled": true,
    "billing_type": "term",
    "term": {
      "unit": "DAY",
      "count": 1
    },
    "billing_interval": {
      "unit": "DAY",
      "count": 1
    },
    "grace_days": 1,
    "points_multiplier": 120,
    "activity_window_months": 1,
    "inactive_points_multiplier": 120,
    "highlight": false,
    "show_payoff": false,
    "product": {
      "id": "id",
      "title": "title",
      "variant_id": "44123456789",
      "variant_title": "variant title",
      "price": "price",
      "currency": "EUR"
    },
    "benefits": [
      {}
    ]
  },
  "product_created": false,
  "would_create_product": {
    "title": "title",
    "price": 1,
    "status": "active"
  },
  "product_status": "product status",
  "gating_republish_failed": false
}

Example

curl -X DELETE "https://charm.appfleece.app/api/v1/program/memberships/<membership_id>" \
  -H "Authorization: Bearer chrm_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"dry_run":false,"if_revision":1}'

Errors

unauthorized · invalid_token · insufficient_scope · access_required · not_found · validation_error · rate_limited · idempotency_conflict · shopify_unavailable

Every error body carries code, message, request_id and a doc_url pointing at the matching entry in the error catalog.