subscription.actor-rbac-seat.change

Deprecated compatibility alias for subscription.actor-rbac-seat.resize. Every reduction requires explicit destructive-loss confirmation.

Deprecated compatibility alias for subscription.actor-rbac-seat.resize.

Overview

Property	Value
Workflow type	Linear
Library	App-subscription
Version	1.1

Input Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	Yes	—	Organization UUID for tenant isolation.
subscription_uuid	uuid	No	—	Optional platform subscription UUID; omitted resolves the active platform subscription.
paid_rbac_actor_seats	integer	No	—	Absolute target paid RBAC actor seat quantity.
add_paid_rbac_actor_seats	integer	No	—	Delta to add to the current paid RBAC actor seat quantity.
proration_behavior	string	No	—	Stripe proration behavior; defaults to always_invoice for seat increases.
confirm_rbac_actor_seat_loss	boolean	No	—	Must be explicitly true for every seat reduction; reductions may immediately revoke Staff actor RBAC tokens.
return_url	string	No	—	Optional browser return URL for Stripe Billing Portal or Checkout handoff.
success_url	string	No	—	Optional Stripe Checkout success return URL for seat increases.
cancel_url	string	No	—	Optional Stripe Checkout cancel return URL for seat increases.
return_channel	json	No	—	Optional notification routing metadata.
agent_session_ref	string	No	—	Optional initiating agent session reference.

Output Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	No	—	Organization UUID.
subscription_uuid	uuid	No	—	Platform subscription UUID.
subscription_status	string	No	—	Current subscription status.
paid_rbac_actor_seats	integer	No	—	New paid RBAC actor seat quantity.
paid_rbac_actor_seats_total	integer	No	—	New paid agent seat pool total.
paid_rbac_actor_seats_used	integer	No	—	Paid Staff actors currently consuming seats.
integration_key_seats_used	integer	No	—	Integration keys consuming the same paid agent pool.
shared_paid_agent_seats_used	integer	No	—	Total paid agent seats currently consumed.
paid_rbac_actor_seats_available	integer	No	—	Remaining paid agent seats after resize.
purchase_required	boolean	No	—	True when no additional paid agent seat is available.
stripe_ready	boolean	No	—	True when Stripe can manage the paid RBAC actor seat item.
current_period_end	string	No	—	Current billing period end timestamp.
explanation	string	No	—	Customer-facing explanation of the paid RBAC seat model.
prior	json	No	—	Prior paid RBAC actor seat quantity.
stripe_calls	list	No	—	Stripe quantity updates attempted by kind and quantity.
proration_behavior	string	No	—	Stripe proration behavior used.
confirmation_required	boolean	No	—	True when a reduction must be confirmed before actor RBAC tokens are revoked.
rbac_actor_seats_to_revoke	integer	No	—	Staff actors that had to lose paid RBAC access for this resize.
pre_revocation_events	list	No	—	Typed rbac_token_revocation audit events emitted before token revocation.
rbac_actor_access_revocations	list	No	—	Staff actor RBAC token revocations performed by this resize.
binding_suspend_actor_uuids	list	No	—	Staff actors whose paid seat this run revoked; their end-user bindings are suspended.
binding_suspend_dispatched	list	No	—	identity.end-user.actor-binding.suspend runs started, as {staff_actor_uuid, workflow_id}.
binding_suspend_failures	list	No	—	Suspend dispatches that failed, as {staff_actor_uuid, error}; the reconcile sweep converges.
operation	string	No	—	subscription_inactive_release when the run released an ended subscription's actors.
release_reason	string	No	—	subscription_inactive for the internal release mode.
release_decision	json	No	—	Why the internal release did or did not revoke paid RBAC actors.
deprecated_workflow_warning	string	No	—	Compatibility warning when the deprecated change alias is used.
stripe_customer_ref	string	No	—	Stripe customer reference used for billing portal handoff.
portal_url	string	No	—	Stripe Billing Portal URL for customer billing management.
checkout_workflow_ref	string	No	—	Seat checkout workflow started for an increase.
checkout	json	No	—	Seat checkout workflow state data.
checkout_url	string	No	—	Stripe Checkout URL for an increase.
stripe_checkout_session_ref	string	No	—	Stripe Checkout Session for an increase.
return_url	string	No	—	Browser return URL used for Stripe handoff.
status	string	No	—	Workflow handoff status.
return_channel	json	No	—	Optional notification routing metadata.
agent_session_ref	string	No	—	Optional initiating agent session reference.
next_action	json	No	—	UI or agent follow-up instruction.
completed_at	string	No	—	Completion timestamp.
failed_at	string	No	—	Failure timestamp.
failure_reason	string	No	—	Failure reason.
failure_type	string	No	—	Failure class or category.
failed_action	string	No	—	Action that failed.
failed_at_state	string	No	—	State where the failure happened.
failed_step	string	No	—	DAG step that failed, when applicable.
failed_layer	string	No	—	Layer that reported the failure.
reason	string	No	—	Engine failure reason.
error	string	No	—	Unexpected error message.
error_type	string	No	—	Unexpected error class.

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	—
resized	No	No	—	complete	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	execute	resized	—
resized	complete	completed	—
pending	fail	failed	—
resized	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "subscription.actor-rbac-seat.change",
  "initial_data": {
    "organization_uuid": "value"
  }
}