---
title: "PATCH /subscriptions"
method: PATCH
path: "/subscriptions"
tags: ["subscriptions"]
---

# PATCH /subscriptions

`PATCH /subscriptions`

## Query parameters

- `id` string, text
- `user_id` string, uuid
- `status` string, public.subscription_status
- `metadata` string, jsonb
- `price_id` string, text
- `quantity` string, integer
- `cancel_at_period_end` string, boolean
- `created` string, timestamp with time zone
- `current_period_start` string, timestamp with time zone
- `current_period_end` string, timestamp with time zone
- `ended_at` string, timestamp with time zone
- `cancel_at` string, timestamp with time zone
- `canceled_at` string, timestamp with time zone
- `trial_start` string, timestamp with time zone
- `trial_end` string, timestamp with time zone
- `organization_id` string, uuid

## Headers

- `Prefer` 'return=representation' | 'return=minimal' | 'return=none'

## Request body

- Subscriptions
  - `id` string, text, required — Note: This is a Primary Key.<pk/>
  - `user_id` string, uuid
  - `status` 'trialing' | 'active' | 'canceled' | 'incomplete' | 'incomplete_expired' | 'past_due' | 'unpaid', public.subscription_status
  - `metadata` unknown
  - `price_id` string, text — Note: This is a Foreign Key to `prices.id`.<fk table='prices' column='id'/>
  - `quantity` integer
  - `cancel_at_period_end` boolean
  - `created` string, timestamp with time zone, required
  - `current_period_start` string, timestamp with time zone, required
  - `current_period_end` string, timestamp with time zone, required
  - `ended_at` string, timestamp with time zone
  - `cancel_at` string, timestamp with time zone
  - `canceled_at` string, timestamp with time zone
  - `trial_start` string, timestamp with time zone
  - `trial_end` string, timestamp with time zone
  - `organization_id` string, uuid, required — Note: This is a Foreign Key to `organization.id`.<fk table='organization' column='id'/>

## Response `204`

No Content

---

[API](https://skmtc.net/revent-app/apis/standard-public-schema.md) · [All operations](https://skmtc.net/revent-app/apis/standard-public-schema/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/revent-app/standard-public-schema/revisions/90ce877204f2/schema)