Sign in

v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
billing

Payment Organization Subscriptions Partial Update 2

PATCH handler with superadmin lock and field protection.

Checks:

  1. Object lock (is_managed=True -> non-superadmins can't modify)
  2. Field protection (non-superadmins can't modify specific fields)
patch/payment/organization-subscriptions/{unique_organization_id}/

Path parameters

unique_organization_idstring required

Headers

Authorizationstring required

JWT access token or Respan API key

Request body

projectstring nullable
subscription_unique_idstring nullable
subscribed_atstring date-time nullable
free_trial_end_atstring date-time nullable
deal_idstring
monthly_recurring_revenuenumber double
expected_annual_contract_valuenumber double
customer_idsstring[]
metered_item_idstring nullable
seat_based_item_idstring nullable
base_item_idstring nullable
stripe_customer_idstring
usage_report_subscription_idstring
subscription_idstring
current_period_startnumber double
current_period_endnumber double
current_usage_period_startnumber double
current_usage_period_endnumber double
usage_in_periodnumber double
keywordsai_llm_credentials_usage_in_periodnumber double
keywordsai_llm_credentials_usage_last_periodnumber double
logs_in_periodinteger
logs_in_last_periodinteger
logs_three_months_agointeger
customer_user_countinteger
prompt_countinteger
evals_in_periodinteger
evals_in_last_periodinteger
member_countinteger
last_usage_reportednumber double
last_reconciled_atnumber double nullable
billing_method'stripe' | 'invoice' | 'other'
  • stripe - Stripe
  • invoice - Invoice
  • other - Other
billing_period'monthly' | 'yearly'
  • monthly - Monthly
  • yearly - Yearly
usage_report_interval'monthly' | 'yearly'
  • monthly - Monthly
  • yearly - Yearly
current_period_invoice_amountnumber double
last_period_invoice_amountnumber double
budgetnumber double nullable
credit_balancenumber double

Current available Keywords AI credit balance in USD

custom_log_limitinteger nullable
custom_plan_namestring
custom_monthly_costnumber double nullable
custom_yearly_costnumber double nullable
{"stackTrail":"components:schemas:PatchedOrganizationSubscriptionDetailRequest:properties:deprecated_subscription_ids","oasType":"schema","type":"unknown","description":"Any type"}
subscription_boolboolean
{"stackTrail":"components:schemas:PatchedOrganizationSubscriptionDetailRequest:properties:custom_subscription","oasType":"schema","type":"unknown","description":"Any type"}
{"stackTrail":"components:schemas:PatchedOrganizationSubscriptionDetailRequest:properties:custom_bundle","oasType":"schema","type":"unknown","description":"Any type"}
accumulative_balancenumber double
periodic_invoice_amountnumber double
orginteger nullable
company_organizationinteger nullable
billing_subscriptioninteger nullable

If set, credits and billing are managed by this subscription (company-level billing). NULL means this subscription manages its own billing (is a primary billing subscription).

organizationinteger nullable

Response

idinteger required
projectstring nullable
subscription_unique_idstring nullable
created_atstring date-time nullable required
subscribed_atstring date-time nullable
free_trial_end_atstring date-time nullable
log_visibility_cutoff_atstring date-time nullable required
deal_idstring
monthly_recurring_revenuenumber double
expected_annual_contract_valuenumber double
customer_idsstring[]
metered_item_idstring nullable
seat_based_item_idstring nullable
base_item_idstring nullable
stripe_customer_idstring
usage_report_subscription_idstring
subscription_idstring
current_period_startnumber double
current_period_endnumber double
current_usage_period_startnumber double
current_usage_period_endnumber double
usage_in_periodnumber double
keywordsai_llm_credentials_usage_in_periodnumber double
keywordsai_llm_credentials_usage_last_periodnumber double
logs_in_periodinteger
logs_in_last_periodinteger
logs_three_months_agointeger
customer_user_countinteger
prompt_countinteger
evals_in_periodinteger
evals_in_last_periodinteger
member_countinteger
last_usage_reportednumber double
last_reconciled_atnumber double nullable
billing_method'stripe' | 'invoice' | 'other'
  • stripe - Stripe
  • invoice - Invoice
  • other - Other
billing_period'monthly' | 'yearly'
  • monthly - Monthly
  • yearly - Yearly
usage_report_interval'monthly' | 'yearly'
  • monthly - Monthly
  • yearly - Yearly
current_period_invoice_amountnumber double
last_period_invoice_amountnumber double
budgetnumber double nullable
credit_balancenumber double

Current available Keywords AI credit balance in USD

custom_log_limitinteger nullable
custom_plan_namestring
custom_monthly_costnumber double nullable
custom_yearly_costnumber double nullable
{"stackTrail":"components:schemas:OrganizationSubscriptionDetail:properties:deprecated_subscription_ids","oasType":"schema","type":"unknown","description":"Any type"}
subscription_boolboolean
{"stackTrail":"components:schemas:OrganizationSubscriptionDetail:properties:custom_subscription","oasType":"schema","type":"unknown","description":"Any type"}
{"stackTrail":"components:schemas:OrganizationSubscriptionDetail:properties:custom_bundle","oasType":"schema","type":"unknown","description":"Any type"}
accumulative_balancenumber double
periodic_invoice_amountnumber double
orginteger nullable
company_organizationinteger nullable
billing_subscriptioninteger nullable

If set, credits and billing are managed by this subscription (company-level billing). NULL means this subscription manages its own billing (is a primary billing subscription).

organizationinteger nullable