export_account #

View this page as Markdown

On this page

Generated automatically from the published contract sources.

A script calls this action over HTTPS at POST https://turnzero.ai/api/v1/export_account, with a bearer credential and the action's payload as the JSON body. It also accepts GET. An MCP connection lists this action as the tool export_account.

OAuth access tokens and minted tokens, including the turnzero command's computer token, are bearer credentials. The action determines which kinds, scopes and grants it accepts (Sign-in, sessions, and tokens).

Build metadata: Registered in this build. Registration describes the default dispatcher in this build. It does not guarantee that a caller has the required credential or grant, that a tool is listed for that connection, or that the required service is configured.

Contract description #

Export your account's declarations and product records as one JSON document, stamped at read_at and read part by part without a snapshot. It includes realm and push configuration and device counts, without end users. Secret and token values are excluded. It lists your pictures by name, size and stamps, without bytes. It includes your feedback and, under your own sign-in, your account's own tzTrack spaces. It holds no tzMesh data. Use tzmesh_export. Unread parts appear in products_not_read. The answer and saved document are marked partial.

Databases and stored files leave through request_export, one application and environment per export. Your source stays with you. Export before seeking deletion on the site.

More about this action #

It holds identities, standing, product profiles and each application's manifest, size, environments, version and deploy state. Push configuration includes provider identifiers and secret names. The document lists storage areas, upstreams, secret names and token records, never their values.

Access and action metadata #

{
  "name": "export_account",
  "resource": "account",
  "tier": "observe",
  "surface": "account",
  "addresses": [
    "tzcloud",
    "tztools"
  ],
  "summary": "The export escape: the account's declarations as one JSON document — the account record, the applications with their manifests, the realm configurations with their device counts, the push configurations, the storage area declarations, the secret names (never values), the upstream declarations, and the token records — with the feedback and the account's own tzTrack spaces, and no tzMesh data, stamped with the time of the read. A product it cannot read leaves the export marked `partial`, with that product in `products_not_read`. The databases' contents and the areas' files leave per application and environment through `request_export`.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  }
}

MCP catalog entry #

{
  "name": "export_account",
  "title": "Export account data",
  "tier": "observe",
  "scenario": "CHI-L0-12",
  "summary": "Export your account's declarations and product records as one JSON document, stamped at `read_at` and read part by part without a snapshot. It includes realm and push configuration and device counts, without end users. Secret and token values are excluded. It lists your pictures by name, size and stamps, without bytes. It includes your feedback and, under your own sign-in, your account's own tzTrack spaces. It holds no tzMesh data. Use `tzmesh_export`. Unread parts appear in `products_not_read`. The answer and saved document are marked `partial`.\n\nDatabases and stored files leave through `request_export`, one application and environment per export. Your source stays with you. Export before seeking deletion on the site.",
  "owners": [
    "ACB-L0-47"
  ]
}

request #

JSON pointer Description and constraints
"" (root) Type: object
Additional properties: false

response #

JSON pointer Description and constraints
"" (root) Type: object
Required fields: ["contract_version","partial","products_not_read","export"]
/properties/contract_version Required value: 1
/properties/partial True where a product could not be read, so the export lacks that product's member or its feedback, or where a minted token asked, which reads no product's member; false where every product the account holds was read.

Type: boolean
/properties/products_not_read Each product the export could not read, by its product word, empty where partial is false. tztrack also covers a feedback member not read.

Type: array
/properties/products_not_read/items Type: string
Allowed values: ["tztrack"]
/properties/reference The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call’s record row. Quote it when you report the call.

Type: string
Pattern: ^[0-9a-f]{10}$
/properties/export Type: object
Required fields: ["read_at","partial","products_not_read","account","applications","realms","areas","custody","upstreams","tokens","push","images"]
/properties/export/properties/read_at Type: string
/properties/export/properties/partial True where a product could not be read, so the export lacks that product's member or its feedback, or where a minted token asked, which reads no product's member; false where every product the account holds was read.

Type: boolean
/properties/export/properties/products_not_read Each product the export could not read, by its product word, empty where partial is false. tztrack also covers a feedback member not read.

Type: array
/properties/export/properties/products_not_read/items Type: string
Allowed values: ["tztrack"]
/properties/export/properties/account Type: object
/properties/export/properties/applications Type: array
/properties/export/properties/applications/items Type: object
Required fields: ["id","name","label","created_at","manifest","environments","state","version"]
/properties/export/properties/applications/items/properties/id Type: string
/properties/export/properties/applications/items/properties/name Type: string
/properties/export/properties/applications/items/properties/label Type: string
/properties/export/properties/applications/items/properties/created_at Type: string
/properties/export/properties/applications/items/properties/size
/properties/export/properties/applications/items/properties/size/anyOf/0 $ref: #/shapes/app_size
/properties/export/properties/applications/items/properties/size/anyOf/1 Type: null
/properties/export/properties/applications/items/properties/unlimited True on the company's own applications, where size is null. Absent on every other application.

Type: boolean
/properties/export/properties/applications/items/properties/manifest Type: ["object","null"]
/properties/export/properties/applications/items/properties/environments Type: array
/properties/export/properties/applications/items/properties/environments/items Type: string
/properties/export/properties/applications/items/properties/state Allowed values: ["deployed","failed","never_deployed"]
/properties/export/properties/applications/items/properties/version Type: ["integer","null"]
/properties/export/properties/realms Type: array
/properties/export/properties/realms/items Type: object
Required fields: ["realm","sign_in_methods","creation","limits","invitation_days","session_days","devices"]
/properties/export/properties/realms/items/properties/realm Type: string
/properties/export/properties/realms/items/properties/sign_in_methods Type: array
/properties/export/properties/realms/items/properties/sign_in_methods/items Type: string
/properties/export/properties/realms/items/properties/creation Allowed values: ["open","invited"]
/properties/export/properties/realms/items/properties/limits Type: object
Required fields: ["creation_ceiling","signin_starts_per_hour","code_sends_per_hour"]
/properties/export/properties/realms/items/properties/limits/properties/creation_ceiling Type: ["integer","null"]
/properties/export/properties/realms/items/properties/limits/properties/signin_starts_per_hour Type: integer
/properties/export/properties/realms/items/properties/limits/properties/code_sends_per_hour Type: integer
/properties/export/properties/realms/items/properties/invitation_days Type: integer
/properties/export/properties/realms/items/properties/session_days Type: integer
/properties/export/properties/realms/items/properties/entra Type: object
Required fields: ["tenant","client_id","client_secret_name"]
/properties/export/properties/realms/items/properties/entra/properties/tenant Type: string
/properties/export/properties/realms/items/properties/entra/properties/client_id Type: string
/properties/export/properties/realms/items/properties/entra/properties/client_secret_name Type: string
/properties/export/properties/realms/items/properties/apple The realm's Sign in with Apple route (the accounts service's work-account statement): the Services ID, the team and key identifiers, and the NAME of the signing key in the application's custody scope — never a value.

Type: object
Required fields: ["services_id","team_id","key_id","key_secret_name"]
Additional properties: false
/properties/export/properties/realms/items/properties/apple/properties/services_id Type: string
/properties/export/properties/realms/items/properties/apple/properties/team_id Type: string
/properties/export/properties/realms/items/properties/apple/properties/key_id Type: string
/properties/export/properties/realms/items/properties/apple/properties/key_secret_name Type: string
/properties/export/properties/realms/items/properties/session_cap_days Type: integer
Minimum: 1
Maximum: 730
/properties/export/properties/realms/items/properties/clients The declared native clients, each without any secret: a native client holds none.

Type: array
Maximum items: 10
/properties/export/properties/realms/items/properties/clients/items Type: object
Required fields: ["client_id","redirect_uris"]
Additional properties: false
/properties/export/properties/realms/items/properties/clients/items/properties/client_id The client's identifier, which it presents at the authorization, token, and revocation endpoints; letters, digits, dots, underscores, colons, and hyphens.

Type: string
/properties/export/properties/realms/items/properties/clients/items/properties/redirect_uris The redirect URIs the client presents, each matched exactly, a loopback URI's port excepted: a reverse-domain custom scheme such as com.example.app:/callback, an https URI on one of the application's own hostnames, or a loopback http URI on localhost, [::1], or 127.0.0.0/8. On the production realm an https URI on the application's custom domain is admitted too. Any other form is refused invalid_redirect_uri.

Type: array
Minimum items: 1
Maximum items: 20
/properties/export/properties/realms/items/properties/clients/items/properties/redirect_uris/items Type: string
/properties/export/properties/realms/items/properties/clients/items/properties/ios Optional. The iOS app's bundle identifier and its ten-character team identifier, for the association files and the native ID-token exchange that later changes serve.

Type: object
Required fields: ["bundle_id","team_id"]
Additional properties: false
/properties/export/properties/realms/items/properties/clients/items/properties/ios/properties/bundle_id Type: string
/properties/export/properties/realms/items/properties/clients/items/properties/ios/properties/team_id Type: string
/properties/export/properties/realms/items/properties/clients/items/properties/android Optional. The Android app's package name and its signing-certificate SHA-256 fingerprints, each 32 upper-case hex pairs separated by colons, for the asset links and the passkey origin that later changes serve.

Type: object
Required fields: ["package","sha256_cert_fingerprints"]
Additional properties: false
/properties/export/properties/realms/items/properties/clients/items/properties/android/properties/package Type: string
/properties/export/properties/realms/items/properties/clients/items/properties/android/properties/sha256_cert_fingerprints Type: array
Minimum items: 1
Maximum items: 10
/properties/export/properties/realms/items/properties/clients/items/properties/android/properties/sha256_cert_fingerprints/items Type: string
/properties/export/properties/realms/items/properties/clients/items/properties/google_client_ids Optional. The Google client identifiers a Google ID token issued for this app has as its audience, for the native ID-token exchange a later change serves.

Type: array
Maximum items: 10
/properties/export/properties/realms/items/properties/clients/items/properties/google_client_ids/items Type: string
/properties/export/properties/realms/items/properties/clients/items/properties/minimum_version Optional. The oldest app version accepted, as major.minor.patch; a request stating a lower version is refused client_upgrade_required.

Type: string
/properties/export/properties/realms/items/properties/clients/items/properties/update_url Optional. An https URL where a refused client is sent to update.

Type: string
/properties/export/properties/realms/items/properties/devices The realm's device registration counts by platform; never a token or a user.

Type: object
Required fields: ["ios","android","invalid"]
Additional properties: false
/properties/export/properties/realms/items/properties/devices/properties/ios Type: integer
/properties/export/properties/realms/items/properties/devices/properties/android Type: integer
/properties/export/properties/realms/items/properties/devices/properties/invalid Type: integer
/properties/export/properties/areas Type: array
/properties/export/properties/areas/items Type: object
Required fields: ["name","account_keyed","version_keeping","application","created_at"]
/properties/export/properties/areas/items/properties/name Type: string
/properties/export/properties/areas/items/properties/account_keyed Type: boolean
/properties/export/properties/areas/items/properties/version_keeping Type: boolean
/properties/export/properties/areas/items/properties/application Type: ["string","null"]
/properties/export/properties/areas/items/properties/created_at Type: string
/properties/export/properties/custody Type: array
/properties/export/properties/custody/items Type: object
Required fields: ["name","scope","created_at"]
/properties/export/properties/custody/items/properties/name Type: string
/properties/export/properties/custody/items/properties/scope Type: string
/properties/export/properties/custody/items/properties/created_at Type: string
/properties/export/properties/custody/items/properties/rotated_at Type: ["string","null"]
/properties/export/properties/custody/items/properties/application Type: ["string","null"]
/properties/export/properties/custody/items/properties/environment The environment of the application scope that holds the value, development or production; null at the account scope.

Type: ["string","null"]
/properties/export/properties/upstreams Type: array
/properties/export/properties/upstreams/items Type: object
Required fields: ["name","base_url","credential_name","auth_header","auth_format","token_shape","application"]
/properties/export/properties/upstreams/items/properties/name Type: string
/properties/export/properties/upstreams/items/properties/base_url Type: string
/properties/export/properties/upstreams/items/properties/credential_name Type: string
/properties/export/properties/upstreams/items/properties/auth_header Type: string
/properties/export/properties/upstreams/items/properties/auth_format Type: string
/properties/export/properties/upstreams/items/properties/token_shape Type: ["string","null"]
/properties/export/properties/upstreams/items/properties/application Type: ["string","null"]
/properties/export/properties/tokens Type: array
/properties/export/properties/tokens/items Type: object
Required fields: ["id","scope_kind","application","grants","label","created_at","expires_at","revoked_at","last_used_at"]
/properties/export/properties/tokens/items/properties/id Type: string
/properties/export/properties/tokens/items/properties/scope_kind Allowed values: ["account","application"]
/properties/export/properties/tokens/items/properties/application Type: ["string","null"]
/properties/export/properties/tokens/items/properties/grants Type: array
/properties/export/properties/tokens/items/properties/grants/items Type: string
/properties/export/properties/tokens/items/properties/label Type: ["string","null"]
/properties/export/properties/tokens/items/properties/created_at Type: string
/properties/export/properties/tokens/items/properties/expires_at Type: ["string","null"]
/properties/export/properties/tokens/items/properties/revoked_at Type: ["string","null"]
/properties/export/properties/tokens/items/properties/last_used_at Type: ["string","null"]
/properties/export/properties/tokens/items/properties/space The space the issues grant applies to; present on a token that carries the grant alone.

Type: string
Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
/properties/export/properties/tokens/items/properties/level The level the issues grant reaches its space at: report, contribute, or owner; present on a token that carries the grant alone.

Allowed values: ["report","contribute","owner"]
/properties/export/properties/tztrack Each issue space of the account's own, read whole with no actor under the space's first token, which a stopped tzTrack tier does not stop. Each lease reads as nobody's. Present under a person's sign-in where the account holds tzTrack and the platform is configured with the service's origin. Whole or absent: a space that could not be read leaves it absent and lists tztrack in products_not_read.

Type: object
Required fields: ["spaces"]
/properties/export/properties/tztrack/properties/spaces One entry per space of the account's own, with that space's whole export joined across its pages.

Type: array
/properties/export/properties/tztrack/properties/spaces/items Type: object
Required fields: ["space","issues","comments","signals","asks","landings","builds","checks"]
/properties/export/properties/tztrack/properties/spaces/items/properties/space The space's identifier, a lower-case UUID.

Type: string
/properties/export/properties/tztrack/properties/spaces/items/properties/issues Type: array
/properties/export/properties/tztrack/properties/spaces/items/properties/issues/items Type: object
/properties/export/properties/tztrack/properties/spaces/items/properties/comments Type: array
/properties/export/properties/tztrack/properties/spaces/items/properties/comments/items Type: object
/properties/export/properties/tztrack/properties/spaces/items/properties/signals Type: array
/properties/export/properties/tztrack/properties/spaces/items/properties/signals/items Type: object
/properties/export/properties/tztrack/properties/spaces/items/properties/asks Type: array
/properties/export/properties/tztrack/properties/spaces/items/properties/asks/items Type: object
/properties/export/properties/tztrack/properties/spaces/items/properties/landings Type: array
/properties/export/properties/tztrack/properties/spaces/items/properties/landings/items Type: object
/properties/export/properties/tztrack/properties/spaces/items/properties/builds Type: array
/properties/export/properties/tztrack/properties/spaces/items/properties/builds/items Type: object
/properties/export/properties/tztrack/properties/spaces/items/properties/checks Type: array
/properties/export/properties/tztrack/properties/spaces/items/properties/checks/items Type: object
/properties/export/properties/feedback The account's own reports, each with its issue projected, and comments it wrote, read whole through the issue service's projection as the account's owner. The plane adds empty signals and asks lists for the copy's readers.

Present when the service's origin is configured. Otherwise absent; a failed read also leaves it absent and lists tztrack in products_not_read. spaces holds those reports, comments and empty lists for each space the account owns, binds, or holds in custody for an application.

Type: object
Required fields: ["issues","comments","signals","asks","spaces"]
/properties/export/properties/feedback/properties/issues Type: array
/properties/export/properties/feedback/properties/issues/items Type: object
/properties/export/properties/feedback/properties/comments Type: array
/properties/export/properties/feedback/properties/comments/items Type: object
/properties/export/properties/feedback/properties/signals Type: array
/properties/export/properties/feedback/properties/signals/items Type: object
/properties/export/properties/feedback/properties/asks Type: array
/properties/export/properties/feedback/properties/asks/items Type: object
/properties/export/properties/feedback/properties/spaces The account's own records in each issue space it owns, binds, or holds in custody for an application, one entry per space: a space of the account's own, an application's own space, and each space of an application's per-environment pair. Each space is read under its own token through the projection, as the platform's space is read. A token that could not be read from custody, or a space that could not be read, leaves the whole feedback member absent and lists tztrack in products_not_read.

Type: array
/properties/export/properties/feedback/properties/spaces/items Type: object
Required fields: ["space","kind","application","environment","issues","comments","signals","asks"]
/properties/export/properties/feedback/properties/spaces/items/properties/space The space's identifier, a lower-case UUID.

Type: string
/properties/export/properties/feedback/properties/spaces/items/properties/kind account for a space of the account's own, application for an application's own space or one space of its per-environment pair.

Type: string
Allowed values: ["account","application"]
/properties/export/properties/feedback/properties/spaces/items/properties/application The application whose space this is, null for a space of the account's own.

Type: ["string","null"]
/properties/export/properties/feedback/properties/spaces/items/properties/environment The environment one space of an application's per-environment pair serves, null for a space serving both.

Type: ["string","null"]
Pattern: ^(development|production)$
/properties/export/properties/feedback/properties/spaces/items/properties/issues Type: array
/properties/export/properties/feedback/properties/spaces/items/properties/issues/items Type: object
/properties/export/properties/feedback/properties/spaces/items/properties/comments Type: array
/properties/export/properties/feedback/properties/spaces/items/properties/comments/items Type: object
/properties/export/properties/feedback/properties/spaces/items/properties/signals Type: array
/properties/export/properties/feedback/properties/spaces/items/properties/signals/items Type: object
/properties/export/properties/feedback/properties/spaces/items/properties/asks Type: array
/properties/export/properties/feedback/properties/spaces/items/properties/asks/items Type: object
/properties/export/properties/push Each environment's push configuration of each application: the providers' identifiers and secret NAMES, never a value.

Type: array
/properties/export/properties/push/items Type: object
Required fields: ["application","environment","apns","fcm"]
Additional properties: false
/properties/export/properties/push/items/properties/application Type: string
/properties/export/properties/push/items/properties/environment Type: string
Allowed values: ["development","production"]
/properties/export/properties/push/items/properties/apns Type: ["object","null"]
Required fields: ["team_id","key_id","bundle_id","key_secret_name","environment"]
Additional properties: false
/properties/export/properties/push/items/properties/apns/properties/team_id The ten-character Apple team identifier.

Type: string
/properties/export/properties/push/items/properties/apns/properties/key_id The ten-character identifier of the APNs signing key.

Type: string
/properties/export/properties/push/items/properties/apns/properties/bundle_id The app's bundle identifier, the notification's topic.

Type: string
/properties/export/properties/push/items/properties/apns/properties/key_secret_name The custody NAME of the stored .p8 signing key at this environment scope; never a value.

Type: string
/properties/export/properties/push/items/properties/apns/properties/environment Which of Apple's two gateways this environment's pushes go to.

Type: string
Allowed values: ["production","sandbox"]
/properties/export/properties/push/items/properties/fcm Type: ["object","null"]
Required fields: ["project_id","service_account_secret_name"]
Additional properties: false
/properties/export/properties/push/items/properties/fcm/properties/project_id The Firebase project identifier.

Type: string
/properties/export/properties/push/items/properties/fcm/properties/service_account_secret_name The custody NAME of the stored service-account JSON file at this environment scope; never a value.

Type: string
/properties/export/properties/images The account's standing pictures saved without an application, each with its name, size and keep stamps. No picture bytes or links are included. Empty where none remain.

Type: array
/properties/export/properties/images/items Type: object
Required fields: ["name","size","created_at","kept_until"]
Additional properties: false
/properties/export/properties/images/items/properties/name The picture's name.

Type: string
/properties/export/properties/images/items/properties/size The picture's size in bytes.

Type: integer
/properties/export/properties/images/items/properties/created_at When the picture was saved, as an ISO 8601 instant.

Type: string
/properties/export/properties/images/items/properties/kept_until When the picture's 7-day keep ends, as an ISO 8601 instant.

Type: string
/properties/detail Type: string
/properties/page $ref: #/shapes/page

Complete payload contract #

{
  "request": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "partial",
      "products_not_read",
      "export"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "partial": {
        "type": "boolean",
        "description": "True where a product could not be read, so the export lacks that product's member or its feedback, or where a minted token asked, which reads no product's member; false where every product the account holds was read (ACB-L0-47)."
      },
      "products_not_read": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "tztrack"
          ]
        },
        "description": "Each product the export could not read, by its product word, empty where `partial` is false (ACB-L0-47). `tztrack` also covers a `feedback` member not read."
      },
      "reference": {
        "type": "string",
        "pattern": "^[0-9a-f]{10}$",
        "description": "The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call’s record row. Quote it when you report the call."
      },
      "export": {
        "type": "object",
        "required": [
          "read_at",
          "partial",
          "products_not_read",
          "account",
          "applications",
          "realms",
          "areas",
          "custody",
          "upstreams",
          "tokens",
          "push",
          "images"
        ],
        "properties": {
          "read_at": {
            "type": "string"
          },
          "partial": {
            "type": "boolean",
            "description": "True where a product could not be read, so the export lacks that product's member or its feedback, or where a minted token asked, which reads no product's member; false where every product the account holds was read (ACB-L0-47)."
          },
          "products_not_read": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "tztrack"
              ]
            },
            "description": "Each product the export could not read, by its product word, empty where `partial` is false (ACB-L0-47). `tztrack` also covers a `feedback` member not read."
          },
          "account": {
            "type": "object"
          },
          "applications": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "name",
                "label",
                "created_at",
                "manifest",
                "environments",
                "state",
                "version"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string"
                },
                "size": {
                  "anyOf": [
                    {
                      "$ref": "#/shapes/app_size"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "unlimited": {
                  "type": "boolean",
                  "description": "True on the company's own applications, where `size` is null. Absent on every other application."
                },
                "manifest": {
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "environments": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "state": {
                  "enum": [
                    "deployed",
                    "failed",
                    "never_deployed"
                  ]
                },
                "version": {
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              }
            }
          },
          "realms": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "realm",
                "sign_in_methods",
                "creation",
                "limits",
                "invitation_days",
                "session_days",
                "devices"
              ],
              "properties": {
                "realm": {
                  "type": "string"
                },
                "sign_in_methods": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "creation": {
                  "enum": [
                    "open",
                    "invited"
                  ]
                },
                "limits": {
                  "type": "object",
                  "required": [
                    "creation_ceiling",
                    "signin_starts_per_hour",
                    "code_sends_per_hour"
                  ],
                  "properties": {
                    "creation_ceiling": {
                      "type": [
                        "integer",
                        "null"
                      ]
                    },
                    "signin_starts_per_hour": {
                      "type": "integer"
                    },
                    "code_sends_per_hour": {
                      "type": "integer"
                    }
                  }
                },
                "invitation_days": {
                  "type": "integer"
                },
                "session_days": {
                  "type": "integer"
                },
                "entra": {
                  "type": "object",
                  "required": [
                    "tenant",
                    "client_id",
                    "client_secret_name"
                  ],
                  "properties": {
                    "tenant": {
                      "type": "string"
                    },
                    "client_id": {
                      "type": "string"
                    },
                    "client_secret_name": {
                      "type": "string"
                    }
                  }
                },
                "apple": {
                  "type": "object",
                  "description": "The realm's Sign in with Apple route (the accounts service's work-account statement): the Services ID, the team and key identifiers, and the NAME of the signing key in the application's custody scope — never a value.",
                  "required": [
                    "services_id",
                    "team_id",
                    "key_id",
                    "key_secret_name"
                  ],
                  "properties": {
                    "services_id": {
                      "type": "string"
                    },
                    "team_id": {
                      "type": "string"
                    },
                    "key_id": {
                      "type": "string"
                    },
                    "key_secret_name": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                },
                "session_cap_days": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 730
                },
                "clients": {
                  "type": "array",
                  "maxItems": 10,
                  "description": "The declared native clients, each without any secret: a native client holds none.",
                  "items": {
                    "type": "object",
                    "required": [
                      "client_id",
                      "redirect_uris"
                    ],
                    "properties": {
                      "client_id": {
                        "type": "string",
                        "description": "The client's identifier, which it presents at the authorization, token, and revocation endpoints; letters, digits, dots, underscores, colons, and hyphens."
                      },
                      "redirect_uris": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 20,
                        "items": {
                          "type": "string"
                        },
                        "description": "The redirect URIs the client presents, each matched exactly, a loopback URI's port excepted: a reverse-domain custom scheme such as `com.example.app:/callback`, an `https` URI on one of the application's own hostnames, or a loopback `http` URI on `localhost`, `[::1]`, or 127.0.0.0/8. On the production realm an `https` URI on the application's custom domain is admitted too (ACS-L0-15). Any other form is refused `invalid_redirect_uri`."
                      },
                      "ios": {
                        "type": "object",
                        "required": [
                          "bundle_id",
                          "team_id"
                        ],
                        "properties": {
                          "bundle_id": {
                            "type": "string"
                          },
                          "team_id": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": false,
                        "description": "Optional. The iOS app's bundle identifier and its ten-character team identifier, for the association files and the native ID-token exchange that later changes serve."
                      },
                      "android": {
                        "type": "object",
                        "required": [
                          "package",
                          "sha256_cert_fingerprints"
                        ],
                        "properties": {
                          "package": {
                            "type": "string"
                          },
                          "sha256_cert_fingerprints": {
                            "type": "array",
                            "minItems": 1,
                            "maxItems": 10,
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "additionalProperties": false,
                        "description": "Optional. The Android app's package name and its signing-certificate SHA-256 fingerprints, each 32 upper-case hex pairs separated by colons, for the asset links and the passkey origin that later changes serve."
                      },
                      "google_client_ids": {
                        "type": "array",
                        "maxItems": 10,
                        "items": {
                          "type": "string"
                        },
                        "description": "Optional. The Google client identifiers a Google ID token issued for this app has as its audience, for the native ID-token exchange a later change serves."
                      },
                      "minimum_version": {
                        "type": "string",
                        "description": "Optional. The oldest app version accepted, as `major.minor.patch`; a request stating a lower version is refused `client_upgrade_required`."
                      },
                      "update_url": {
                        "type": "string",
                        "description": "Optional. An `https` URL where a refused client is sent to update."
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "devices": {
                  "type": "object",
                  "required": [
                    "ios",
                    "android",
                    "invalid"
                  ],
                  "properties": {
                    "ios": {
                      "type": "integer"
                    },
                    "android": {
                      "type": "integer"
                    },
                    "invalid": {
                      "type": "integer"
                    }
                  },
                  "additionalProperties": false,
                  "description": "The realm's device registration counts by platform; never a token or a user (PSH-L0-06)."
                }
              }
            }
          },
          "areas": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "account_keyed",
                "version_keeping",
                "application",
                "created_at"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "account_keyed": {
                  "type": "boolean"
                },
                "version_keeping": {
                  "type": "boolean"
                },
                "application": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "created_at": {
                  "type": "string"
                }
              }
            }
          },
          "custody": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "scope",
                "created_at"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "scope": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string"
                },
                "rotated_at": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "application": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "environment": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The environment of the application scope that holds the value, `development` or `production`; null at the account scope (SCRT-L0-08)."
                }
              }
            }
          },
          "upstreams": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "base_url",
                "credential_name",
                "auth_header",
                "auth_format",
                "token_shape",
                "application"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "base_url": {
                  "type": "string"
                },
                "credential_name": {
                  "type": "string"
                },
                "auth_header": {
                  "type": "string"
                },
                "auth_format": {
                  "type": "string"
                },
                "token_shape": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "application": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "tokens": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "scope_kind",
                "application",
                "grants",
                "label",
                "created_at",
                "expires_at",
                "revoked_at",
                "last_used_at"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "scope_kind": {
                  "enum": [
                    "account",
                    "application"
                  ]
                },
                "application": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "grants": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "label": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "created_at": {
                  "type": "string"
                },
                "expires_at": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "revoked_at": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "last_used_at": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "space": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
                  "description": "The space the issues grant applies to; present on a token that carries the grant alone."
                },
                "level": {
                  "enum": [
                    "report",
                    "contribute",
                    "owner"
                  ],
                  "description": "The level the issues grant reaches its space at: report, contribute, or owner; present on a token that carries the grant alone."
                }
              }
            }
          },
          "tztrack": {
            "type": "object",
            "description": "Each issue space of the account's own, read whole with no actor under the space's first token, which a stopped tzTrack tier does not stop (ACB-L0-47; ITS-L0-05). Each lease reads as nobody's. Present under a person's sign-in where the account holds tzTrack and the platform is configured with the service's origin. Whole or absent: a space that could not be read leaves it absent and lists `tztrack` in `products_not_read`.",
            "required": [
              "spaces"
            ],
            "properties": {
              "spaces": {
                "type": "array",
                "description": "One entry per space of the account's own, with that space's whole export joined across its pages.",
                "items": {
                  "type": "object",
                  "required": [
                    "space",
                    "issues",
                    "comments",
                    "signals",
                    "asks",
                    "landings",
                    "builds",
                    "checks"
                  ],
                  "properties": {
                    "space": {
                      "type": "string",
                      "description": "The space's identifier, a lower-case UUID."
                    },
                    "issues": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "comments": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "signals": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "asks": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "landings": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "builds": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "checks": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "feedback": {
            "type": "object",
            "description": "The account's own reports, each with its issue projected, and comments it wrote, read whole through the issue service's projection as the account's owner (ACB-L0-47). The plane adds empty `signals` and `asks` lists for the copy's readers.\n\nPresent when the service's origin is configured. Otherwise absent; a failed read also leaves it absent and lists `tztrack` in `products_not_read`. `spaces` holds those reports, comments and empty lists for each space the account owns, binds, or holds in custody for an application.",
            "required": [
              "issues",
              "comments",
              "signals",
              "asks",
              "spaces"
            ],
            "properties": {
              "issues": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "comments": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "signals": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "asks": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "spaces": {
                "type": "array",
                "description": "The account's own records in each issue space it owns, binds, or holds in custody for an application, one entry per space: a space of the account's own, an application's own space, and each space of an application's per-environment pair (ACB-L0-47). Each space is read under its own token through the projection, as the platform's space is read. A token that could not be read from custody, or a space that could not be read, leaves the whole `feedback` member absent and lists `tztrack` in `products_not_read`.",
                "items": {
                  "type": "object",
                  "required": [
                    "space",
                    "kind",
                    "application",
                    "environment",
                    "issues",
                    "comments",
                    "signals",
                    "asks"
                  ],
                  "properties": {
                    "space": {
                      "type": "string",
                      "description": "The space's identifier, a lower-case UUID."
                    },
                    "kind": {
                      "type": "string",
                      "enum": [
                        "account",
                        "application"
                      ],
                      "description": "`account` for a space of the account's own, `application` for an application's own space or one space of its per-environment pair."
                    },
                    "application": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The application whose space this is, null for a space of the account's own."
                    },
                    "environment": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "pattern": "^(development|production)$",
                      "description": "The environment one space of an application's per-environment pair serves, null for a space serving both."
                    },
                    "issues": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "comments": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "signals": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "asks": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    }
                  }
                }
              }
            }
          },
          "push": {
            "type": "array",
            "description": "Each environment's push configuration of each application: the providers' identifiers and secret NAMES, never a value (PSH-L0-06).",
            "items": {
              "type": "object",
              "required": [
                "application",
                "environment",
                "apns",
                "fcm"
              ],
              "properties": {
                "application": {
                  "type": "string"
                },
                "environment": {
                  "type": "string",
                  "enum": [
                    "development",
                    "production"
                  ]
                },
                "apns": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "required": [
                    "team_id",
                    "key_id",
                    "bundle_id",
                    "key_secret_name",
                    "environment"
                  ],
                  "properties": {
                    "team_id": {
                      "type": "string",
                      "description": "The ten-character Apple team identifier."
                    },
                    "key_id": {
                      "type": "string",
                      "description": "The ten-character identifier of the APNs signing key."
                    },
                    "bundle_id": {
                      "type": "string",
                      "description": "The app's bundle identifier, the notification's topic."
                    },
                    "key_secret_name": {
                      "type": "string",
                      "description": "The custody NAME of the stored .p8 signing key at this environment scope; never a value."
                    },
                    "environment": {
                      "type": "string",
                      "enum": [
                        "production",
                        "sandbox"
                      ],
                      "description": "Which of Apple's two gateways this environment's pushes go to."
                    }
                  },
                  "additionalProperties": false
                },
                "fcm": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "required": [
                    "project_id",
                    "service_account_secret_name"
                  ],
                  "properties": {
                    "project_id": {
                      "type": "string",
                      "description": "The Firebase project identifier."
                    },
                    "service_account_secret_name": {
                      "type": "string",
                      "description": "The custody NAME of the stored service-account JSON file at this environment scope; never a value."
                    }
                  },
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            }
          },
          "images": {
            "type": "array",
            "description": "The account's standing pictures saved without an application, each with its name, size and keep stamps. No picture bytes or links are included. Empty where none remain.",
            "items": {
              "type": "object",
              "required": [
                "name",
                "size",
                "created_at",
                "kept_until"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "description": "The picture's name."
                },
                "size": {
                  "type": "integer",
                  "description": "The picture's size in bytes."
                },
                "created_at": {
                  "type": "string",
                  "description": "When the picture was saved, as an ISO 8601 instant."
                },
                "kept_until": {
                  "type": "string",
                  "description": "When the picture's 7-day keep ends, as an ISO 8601 instant."
                }
              },
              "additionalProperties": false
            }
          }
        }
      },
      "detail": {
        "type": "string"
      },
      "page": {
        "$ref": "#/shapes/page"
      }
    }
  }
}

Shared contracts #