subscription.actor-rbac-seat.status

Show paid RBAC actor seat availability and current consumers.

Report paid RBAC actor seat availability for a platform subscription.

Overview

Property	Value
Workflow type	Atomic
Library	App-subscription
Version	1.0

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.
include_consumers	boolean	No	—	Include current Staff actor and integration key consumers.

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_total	integer	No	—	Purchased paid agent seats available to RBAC actors and integration keys.
paid_rbac_actor_seats_used	integer	No	—	Paid Staff actors currently consuming seats.
integration_key_seats_used	integer	No	—	Integration keys currently consuming the same paid agent pool.
shared_paid_agent_seats_used	integer	No	—	Total paid agent seats consumed across Staff actors and integration keys.
paid_rbac_actor_seats_available	integer	No	—	Remaining paid agent seats available for RBAC actors.
purchase_required	boolean	No	—	True when no paid agent seat is available.
stripe_ready	boolean	No	—	True when the Stripe seat item exists or can be created from configured Stripe billing env.
current_period_end	string	No	—	Current billing period end timestamp.
explanation	string	No	—	Customer-facing explanation of the paid RBAC seat model.
consumers	list	No	—	Optional UUID-only current seat consumers.
error	string	No	—	Read error, when returned by the data workflow base.
error_type	string	No	—	Read error class, when available.

States

State	Initial	Terminal	Success	Auto-advance	Description
done	Yes	Yes	Yes	—	—

API Usage

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

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