---
title: "Remove the Archie tier from a subscription"
method: DELETE
path: "/subscriptions/{id}/archie-tier"
tags: ["Subscriptions"]
---

# Remove the Archie tier from a subscription

`DELETE /subscriptions/{id}/archie-tier`

## Request

- Base URL: `https://api.smokeball.com`
- URL: `https://api.smokeball.com/subscriptions/{id}/archie-tier`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

The removal is scheduled for the end of the current billing period.
Calling this endpoint when the subscription has no Archie tier is a no-op.

## Path parameters

- `id` string, required

## Response `202`

When request is accepted. Returns a 'Link' object.

- Link
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable

## Other responses

- `400`: When the subscription cannot be updated.
- `404`: When the subscription does not exist.
- `500`: Internal Server Error

## Changes

- **2026-09-12** `30062b3c3dd5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smokeball/apis/smokeball-api/changes/subscriptions/:id/archie-tier/delete.md)

---

[API](https://skmtc.dev/smokeball/apis/smokeball-api.md) - [All operations](https://skmtc.dev/smokeball/apis/smokeball-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smokeball/apis/smokeball-api/revisions/6e350cf667d4?raw)