---
title: "Revoke a Stripe customer alias"
method: POST
path: "/admin/billing/stripe/customer-aliases/{customer_id}/revoke"
tags: ["Billing"]
---

# Revoke a Stripe customer alias

`POST /admin/billing/stripe/customer-aliases/{customer_id}/revoke`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/admin/billing/stripe/customer-aliases/{customer_id}/revoke`
- Auth: API key in header `x-api-key`

Revokes an active historical Stripe customer alias by `customer_id` (admin only). The revoke is soft: the audit record stays stored, but the alias is no longer used to resolve customers. Returns the alias with its `status`, `revoked_at`, `revoked_by`, `user_id` and `source`.

## Path parameters

- `customer_id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

Revoked alias

- BillingStripeCustomerAliasResponseDoc
  - `code` integer
  - `data` BillingStripeCustomerAliasDoc
    - `created_at` string
    - `created_by` string
    - `reason` string
    - `revoked_at` string
    - `revoked_by` string
    - `source` string
    - `status` string
    - `stripe_customer_id` string
    - `updated_at` string
    - `updated_by` string
    - `user_id` string
  - `msg` string

## Other responses

- `400`: Invalid customer id
- `401`: Authentication required
- `403`: Admin plan required
- `404`: Active alias not found
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)