> ## 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.

# Cancelar plan

> Cancela un plan y cancela en cascada todas las suscripciones vinculadas a él en ese momento.

> [!CAUTION]
>
> **La cancelación en cascada es síncrona e inmediata**
>
> Cancelar un plan cancela de inmediato todas las suscripciones que tiene, no hay forma de cancelar el plan sin cancelar también a sus suscriptores. Revisa `affected_subscriptions` en la respuesta para saber cuántas se vieron afectadas.
>
> Volver a cancelar un plan que ya está en estado `CANCELED` es seguro y vuelve a ejecutar la cascada: devuelve `200` de nuevo, no un error. Esto es deliberado: es la vía de recuperación si una cascada anterior no logró cancelar algunas suscripciones, así que reintenta la llamada de cancelación si no estás seguro de que se completó por completo. `INVALID_STATE` (`400`) se reserva para un estado del plan distinto de `ACTIVE`/`CANCELED`, algo que hoy no puede ocurrir, ya que esos son los únicos dos estados de un plan.


## OpenAPI

````yaml openapi/es/plans/cancel-plan.json POST /subscriptions/plans/{plan_id}/status
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)
security:
  - sec0: []
    sec1: []
paths:
  /subscriptions/plans/{plan_id}/status:
    post:
      summary: Cancelar plan
      description: >-
        La única transición de estado admitida. Cancelar un plan bloquea nuevas
        suscripciones Y cancela en cascada, de forma síncrona, todas las
        suscripciones vinculadas a él en ese momento.
      operationId: cancel-plan
      parameters:
        - in: header
          name: X-Account-Code
          required: true
          schema:
            type: string
          description: >-
            El `account_id` que se encuentra en tu [Yuno
            Dashboard](https://dashboard.y.uno/developers) (UUID). Obligatorio:
            si lo omites, se devuelve `400 BAD_REQUEST` ("Invalid x-account-code
            header.").
        - name: plan_id
          in: path
          description: El identificador único del plan.
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - status
              properties:
                status:
                  type: string
                  enum:
                    - CANCELED
            examples:
              Result:
                value:
                  status: CANCELED
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    id: 00000000-0000-4000-8000-000000000001
                    status: CANCELED
                    affected_subscriptions: 3
              schema:
                type: object
                properties:
                  id:
                    type: string
                  status:
                    type: string
                  affected_subscriptions:
                    type: integer
                    description: >-
                      El número de suscripciones que se cancelaron en cascada
                      junto con el plan.
        '400':
          description: >-
            400. Reservado para un estado de plan distinto de ACTIVE/CANCELED:
            por ahora no se puede alcanzar, ya que esos son los únicos dos
            estados del plan hoy. Volver a cancelar un plan que ya está CANCELED
            NO llega aquí: vuelve a ejecutar la cascada y devuelve 200.
          content:
            application/json:
              examples:
                Result:
                  value:
                    code: INVALID_STATE
                    messages:
                      - The plan state does not support the action requested.
                  summary: Result
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: INVALID_STATE
                  messages:
                    type: array
                    items:
                      type: string
      deprecated: false
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.