Remove a pet

DELETE /customers/{customer_id}/pets/{pet_id}


Scope	`customers:write`
Customer session token	Accepted with the `write` scope, for the token’s own customer
Rate limit class	`write` (limits)
Idempotency key	Required (idempotency)
MCP tool	`charm_remove_customer_pet`

Parameters

Name	In	Type	Description
`customer_id`	path	string	Shopify customer GID (percent-encoded, e.g. `gid%3A%2F%2Fshopify%2FCustomer%2F123`) or the numeric customer id.
`pet_id`	path	string	The pet’s `id`.

Response `200`

Returns PetsResult.

Field	Type	Description
`changed`	boolean
`pets`	array of Subject

{
  "changed": true,
  "pets": [
    {
      "id": "id",
      "name": "Gold",
      "birthday": "birthday",
      "species": "species",
      "updated_at": "2026-10-01T09:30:00.000Z"
    }
  ]
}

Example

curl -X DELETE "https://charm.appfleece.app/api/v1/customers/7712345/pets/<pet_id>" \
  -H "Authorization: Bearer chrm_live_..." \
  -H "Idempotency-Key: $(uuidgen)"

Errors

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

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