> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Remove Promotion from Plan

> Removes a promotion from a subscription plan. Subscriptions that already have the promotion keep their copy

Removes the attachment of a promotion from a plan. The plan no longer offers the promotion, so it cannot be applied to new subscriptions on the plan. Subscriptions that already have the promotion are not changed: they keep their copy until it is `COMPLETED` or `ENDED`.

The response has no body. To end the promotion on one subscription, use [Remove Promotion from Subscription](https://docs.y.uno/reference/subscriptions/remove-subscription-promotion.md).

> [!NOTE]
>
> **Changing `cycles`**
>
> Attachments are not edited. To change `cycles` or `on_pause`, remove the attachment with this endpoint and then [attach the promotion again](https://docs.y.uno/reference/plans/attach-plan-promotion.md).

## Errors

| HTTP | `code` | When |
| :- | :- | :- |
| `404` | `PLAN_NOT_FOUND` | The plan does not exist. |
| `404` | `PROMOTION_NOT_FOUND` | The promotion is not attached to this plan. |


## OpenAPI

````yaml openapi/plans/remove-plan-promotion.json DELETE /subscriptions/plans/{plan_id}/promotions/{promotion_id}
openapi: 3.1.0
info:
  title: plans
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
  - url: https://api.eu.y.uno/v1
    description: Production (EMEA)
security:
  - sec0: []
    sec1: []
paths:
  /subscriptions/plans/{plan_id}/promotions/{promotion_id}:
    delete:
      summary: Remove Promotion from Plan
      description: >-
        Removes the attachment of a promotion from the plan. Subscriptions that
        already have the promotion are not changed: they keep their copy until
        it is `COMPLETED` or `ENDED`.
      operationId: remove-plan-promotion
      parameters:
        - in: header
          name: X-Account-Code
          required: true
          schema:
            type: string
          description: >-
            The `account_id` found in your [Yuno
            Dashboard](https://dashboard.y.uno/developers) (UUID). Required —
            omitting it returns `400 BAD_REQUEST` ("Invalid x-account-code
            header.").
        - name: plan_id
          in: path
          description: The unique identifier of the plan.
          schema:
            type: string
          required: true
        - name: promotion_id
          in: path
          description: The ID of the promotion to remove from the plan (UUID).
          schema:
            type: string
          required: true
      responses:
        '204':
          description: >-
            204. The promotion was removed from the plan. The response has no
            body.
        '404':
          description: >-
            404. The plan does not exist (`PLAN_NOT_FOUND`), or the promotion is
            not attached to this plan (`PROMOTION_NOT_FOUND`).
          content:
            application/json:
              examples:
                Result:
                  value:
                    code: PROMOTION_NOT_FOUND
                    messages:
                      - Promotion not found.
              schema:
                type: object
                properties:
                  code:
                    type: string
                  messages:
                    type: array
                    items:
                      type: string
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: public-api-key
      x-default: <Your public-api-key>
    sec1:
      type: apiKey
      in: header
      name: private-secret-key
      x-default: <Your private-secret-key>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.