---
schema: formation.doc/v0.1
kind: doc
visibility: public
canonical_url: https://topologyindex.com/docs/schemas/account_status/v0.1.md
document_kind: account_status
document_schema: formation.account_status/v0.1
max_document_bytes: 262144
path: /docs/schemas/account_status/v0.1.md
product_api_version: v1
schema_version: v0.1
title: formation.account_status/v0.1
---

# formation.account_status/v0.1

Frontmatter fields of a `account_status` document. Every security-, cost- and execution-relevant
value is a typed field; prose in the body can explain a rule but never override it. Undeclared
fields are rejected.

## Fields

- `schema` (required): exactly `formation.account_status/v0.1`
- `kind` (required): exactly `account_status`
- `updated_at` (required): ISO 8601 UTC timestamp, pattern `^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?Z$`, at most 30 characters
- `coordinator_sequence` (required): integer from 0 to 9007199254740991
- `credential_scopes` (required): array of 0 to 12 items, each one of `artifacts:read`, `formations:write`, `recommendations:read`, `evaluations:plan`, `evaluations:start`, `evaluations:read`, `evaluations:cancel`, `runs:report`, `adoptions:write`, `subscriptions:write`, `events:read`, `account:read`
- `entitlements` (required): map (fields listed below)
- `entitlements.plan` (required): one of `none`, `pilot`, `recurring_workspace`
- `entitlements.state` (required): one of `active`, `suspended`, `expired`
- `entitlements.workloads` (required): integer from 0 to 1000000000
- `entitlements.comparison_cycles_per_month` (required): integer from 0 to 1000000000
- `entitlements.expires_at` (required): null or ISO 8601 UTC timestamp, pattern `^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?Z$`, at most 30 characters
- `spending_policy` (required): map (fields listed below)
- `spending_policy.version` (required): integer from 0 to 1000000000
- `spending_policy.monthly_allowance_usd_micros` (required): integer from 0 to 1000000000000000
- `spending_policy.per_evaluation_cap_usd_micros` (required): integer from 0 to 1000000000000000
- `spending_policy.max_concurrent_episodes` (required): integer from 0 to 64
- `spending_policy.automatic_starts_permitted` (required): boolean
- `usage` (required): map (fields listed below)
- `usage.period_start` (required): ISO 8601 UTC timestamp, pattern `^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?Z$`, at most 30 characters
- `usage.period_end` (required): ISO 8601 UTC timestamp, pattern `^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{1,9}))?Z$`, at most 30 characters
- `usage.evaluation_reserved_usd_micros` (required): integer from 0 to 1000000000000000
- `usage.evaluation_settled_usd_micros` (required): integer from 0 to 1000000000000000
- `usage.outstanding_liability_usd_micros` (required): integer from 0 to 1000000000000000
- `usage.customer_reported_production_spend_usd_micros` (required): null or integer from 0 to 1000000000000000
- `usage.active_jobs` (required): integer from 0 to 1000000000
- `usage.recommendation_requests` (required): integer from 0 to 1000000000
- `usage.evaluation_plans_created` (required): integer from 0 to 1000000000
- `usage.reports_ingested` (required): integer from 0 to 1000000000
- `usage.stored_document_bytes` (required): integer from 0 to 9007199254740991
- `quotas` (optional): map (fields listed below)
- `quotas.active_jobs` (required): integer from 0 to 1000000000
- `quotas.recommendation_requests_per_month` (required): integer from 0 to 1000000000
- `quotas.evaluation_plans_per_month` (required): integer from 0 to 1000000000
- `quotas.reports_per_month` (required): integer from 0 to 1000000000
- `quotas.stored_document_bytes` (required): integer from 0 to 9007199254740991
- `owner_approval_required` (required): array of 0 to 4 items, each one of `increase_budget`, `enable_public_sharing`, `broaden_credential`, `upgrade_plan`