Edit a subscription

Once a plan has been assigned to a customer, whether it’s in a pending or active state, you can make edits to the subscription by following these steps:

Dashboard
API

Click the three dots menu icon and select “Edit subscription”;
Subscription start date
You can modify the subscription start date if the subscription is pending and the chosen date is later than today. See the guidelines for subscription start date;
Subscription end date
You can also change the subscription end date. See the guidelines for subscription end date; and
You can edit any prices listed for a subscription, including charges, commitments, tiers and spending minimums.

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
EXTERNAL_ID="__YOUR_SUBSCRIPTION_ID__"

curl --location --request PUT "$LAGO_URL/api/v1/subscriptions/$EXTERNAL_ID" \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "subscription": {
    "name": "Repository 1",
    "subscription_at": "2022-08-08T00:00:00Z",
    "ending_at": "2023-08-08T00:00:00Z",
    "plan_overrides": {
      "name": "new_plan",
      "invoice_display_name": "Subscription fee",
      "description": "Overridden plan for customer X",
      "charges": [
        {
          "id": "cac4cff7-e2d9-41e2-83e5-7947d91f0eb5",
          "invoice_display_name": "Cards - custom price",
          "properties": {
            "amount": "10"
          }
        }
      ],
      "fixed_charges": [
        {
          "id": "af360881-357a-4334-ad16-8cd38e246d03",
          "units": 20,
          "apply_units_immediately": true
        }
      ]
    }
  }
}'

Fixed charges are updated under plan_overrides, using the fixed_charges array. Sending only units (and apply_units_immediately if needed) updates the quantity without creating a plan override. Passing a price or properties creates one. See Update a fixed charge via the API.

Introduction

Get started

Events & Usage Components

Pricing & Subscriptions

Quotes & Order Forms

Invoicing

Payments & Cash Collection

AI Agents and MCP

Data & Analytics

Revenue recognition

Resources

Edit a subscription