Update a subscription plan

POST https://api.tamio.com/v2/subscriptions/update/{uuid}

Switches the billing plan of an existing subscription. Specify the target product and pricing model. Optionally adjust the quantity and enable prorated billing for mid-cycle changes.

Path Parameters

uuid string*

UUID of the subscription to update.

Body Parameters

id string*

UUID of the target product/plan to switch to.

pricing_model_id string*

UUID of the pricing model to apply.

quantity integer

Subscription quantity (seats/licenses).

prorations boolean

Apply prorated billing for mid-cycle changes.

Responses

200 Plan switched successfully

Plan switched successfully

status integer

subscription Subscription

upcoming_invoice object

Preview of the next invoice after the change.

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Subscription or target product not found
`10045`	Invalid or missing pricing model selection
`10256`	A pending subscription update job already exists
`10287`	Plan was switched too recently
`90041`	Payment gateway does not support this operation

status integer

error string

error_code integer

401 Missing or invalid API key

Retrieve a subscription

Cancel a subscription

/subscriptions/update/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/subscriptions/update/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "id": "ddd44567-e89b-12d3-a456-426614174000",
9     "pricing_model_id": "eee54567-e89b-12d3-a456-426614174000",
10     "quantity": 1,
11     "prorations": true
12   })
13 });
14 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/subscriptions/update/{uuid}")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   id: "ddd44567-e89b-12d3-a456-426614174000",
16   pricing_model_id: "eee54567-e89b-12d3-a456-426614174000",
17   quantity: 1,
18   prorations: true
19 }.to_json
20 
21 response = https.request(request)
22 puts response.read_body

Responses

{
  "status": 200,
  "subscription": {
    "id": "999e4567-e89b-12d3-a456-426614174000",
    "object": "subscription",
    "next_billing_date": 1735689600,
    "cancellation_date": null,
    "completion_date": null,
    "resumes_at": null,
    "products": [
      {
        "id": "bbb24567-e89b-12d3-a456-426614174000",
        "name": "Pro Plan"
      }
    ],
    "payment_count": 12,
    "status": "active",
    "has_discount": false,
    "gateway_subscription_id": "sub_1PaBcDeFgHiJkLmN",
    "type": "subscription",
    "gateway": "stripe",
    "billing_cycle": "month",
    "interval": 1,
    "currency": "EUR",
    "invoice_id": "aaa14567-e89b-12d3-a456-426614174000",
    "price": 2990,
    "lifetime_revenue": 35880,
    "management_link": "https://billing.example.com",
    "instalments_count": 0,
    "customer": "...",
    "imported": false,
    "has_notes": false
  },
  "upcoming_invoice": {}
}

1	const response = await fetch("https://api.tamio.com/v2/subscriptions/update/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"id": "ddd44567-e89b-12d3-a456-426614174000",
9	"pricing_model_id": "eee54567-e89b-12d3-a456-426614174000",
10	"quantity": 1,
11	"prorations": true
12	})
13	});
14	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/subscriptions/update/{uuid}")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	id: "ddd44567-e89b-12d3-a456-426614174000",
16	pricing_model_id: "eee54567-e89b-12d3-a456-426614174000",
17	quantity: 1,
18	prorations: true
19	}.to_json
20
21	response = https.request(request)
22	puts response.read_body