---
title: "Delete a payment method"
method: DELETE
path: "/api/space/payment_methods/{id}"
tags: ["Space Billing"]
---

# Delete a payment method

`DELETE /api/space/payment_methods/{id}`

Removes a card from the space. The card that auto top-up charges cannot be deleted
(`payment_method_is_active_topup_source`); point auto top-up at another card or
disable it first with
[Update low balance settings](/docs/apis/rest/space/balance/update-low-balance-setting).

#### Permissions

Authenticate with a [Personal access token](/docs/apis/authorization#personal-access-tokens) whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder's role in the space is the whole authorization decision.

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Response `204`

There is no content to send for this request, but the headers may be useful.

## Other responses

- `401` — The credential is missing, unknown, or revoked; its holder is not a member of the space in the subdomain; the member is not an owner or admin; or billing for this space is not managed in the space itself, which is the case for a space purchased through a cloud marketplace and for a suspended or deactivated space. A space deactivated for nonpayment keeps the billing endpoints so that its outstanding balance can be settled. The body is the plain text `Unauthorized`. An unverified space instead receives the JSON body `{"message": "Please validate a phone number to access your account."}` on every endpoint under `/api/space`.
- `404` — The member, project, or payment method does not exist in this space. The body is the plain text `Not Found`.
- `422` — The card is the active auto top-up source (`payment_method_is_active_topup_source`). Change or disable auto top-up with [Update low balance settings](/docs/apis/rest/space/balance/update-low-balance-setting) first.
- `500` — An internal server error occurred.

## Changes

> 161 revisions in range; 3 could not be searched.

- **2026-09-15** `45bac4fd93ab` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/signalwire/apis/signalwire-rest-api/changes/api/space/payment_methods/:id/delete.md)

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/20ee0f568ece?raw)