Actualizar una suscripción

post/v1/subscriptions/{id}

Cambia el plan, la metadata o programa la cancelación. Los cambios de plan aplican al próximo período.

Request

BASH

curl -X POST https://api.cauril.com/v1/subscriptions/<id> \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "plan_01J...",
    "cancel_at_period_end": true,
    "metadata": {}
  }'

Parámetros

idpathreq

string

Cuerpo UpdateSubscription

plan	string	Cambio de plan; aplica al próximo período.
cancel_at_period_end	boolean
metadata	object

Respuestas

200	Suscripción actualizada	Subscription
404	Error	Error
409	Error	Error
422	Error	Error

Ejemplo de respuesta · 200

JSON

{
  "object": "subscription",
  "id": "sub_01J...",
  "status": "incomplete",
  "customer_id": "cus_01J...",
  "plan_id": "plan_01J...",
  "provider": "stripe",
  "engine": "native",
  "current_period_start": "2026-06-01T12:00:00Z",
  "current_period_end": "2026-06-01T12:00:00Z",
  "cancel_at_period_end": true,
  "trial_end": null,
  "provider_subscription_id": null,
  "metadata": {},
  "latest_invoice": null,
  "created_at": "2026-06-01T12:00:00Z",
  "updated_at": "2026-06-01T12:00:00Z"
}