export_account #
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"] |
| / |
Required value: 1 |
| / |
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 |
| / |
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 |
| / |
Type: string Allowed values: ["tztrack"] |
| / |
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}$ |
| / |
Type: object Required fields: ["read_at","partial","products_not_read","account","applications","realms","areas","custody","upstreams","tokens","push","images"] |
| / |
Type: string |
| / |
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 |
| / |
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 |
| / |
Type: string Allowed values: ["tztrack"] |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object Required fields: ["id","name","label","created_at","manifest","environments","state","version"] |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
|
| / |
$ref: #/shapes/app_size |
| / |
Type: null |
| / |
True on the company's own applications, where size is null. Absent on every other application.Type: boolean |
| / |
Type: ["object","null"] |
| / |
Type: array |
| / |
Type: string |
| / |
Allowed values: ["deployed","failed","never_deployed"] |
| / |
Type: ["integer","null"] |
| / |
Type: array |
| / |
Type: object Required fields: ["realm","sign_in_methods","creation","limits","invitation_days","session_days","devices"] |
| / |
Type: string |
| / |
Type: array |
| / |
Type: string |
| / |
Allowed values: ["open","invited"] |
| / |
Type: object Required fields: ["creation_ceiling","signin_starts_per_hour","code_sends_per_hour"] |
| / |
Type: ["integer","null"] |
| / |
Type: integer |
| / |
Type: integer |
| / |
Type: integer |
| / |
Type: integer |
| / |
Type: object Required fields: ["tenant","client_id","client_secret_name"] |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
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 |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
Type: integer Minimum: 1 Maximum: 730 |
| / |
The declared native clients, each without any secret: a native client holds none. Type: array Maximum items: 10 |
| / |
Type: object Required fields: ["client_id","redirect_uris"] Additional properties: false |
| / |
The client's identifier, which it presents at the authorization, token, and revocation endpoints; letters, digits, dots, underscores, colons, and hyphens. Type: string |
| / |
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 |
| / |
Type: string |
| / |
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 |
| / |
Type: string |
| / |
Type: string |
| / |
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 |
| / |
Type: string |
| / |
Type: array Minimum items: 1 Maximum items: 10 |
| / |
Type: string |
| / |
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 |
| / |
Type: string |
| / |
Optional. The oldest app version accepted, as major.minor.patch; a request stating a lower version is refused client_upgrade_required.Type: string |
| / |
Optional. An https URL where a refused client is sent to update.Type: string |
| / |
The realm's device registration counts by platform; never a token or a user. Type: object Required fields: ["ios","android","invalid"] Additional properties: false |
| / |
Type: integer |
| / |
Type: integer |
| / |
Type: integer |
| / |
Type: array |
| / |
Type: object Required fields: ["name","account_keyed","version_keeping","application","created_at"] |
| / |
Type: string |
| / |
Type: boolean |
| / |
Type: boolean |
| / |
Type: ["string","null"] |
| / |
Type: string |
| / |
Type: array |
| / |
Type: object Required fields: ["name","scope","created_at"] |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
Type: ["string","null"] |
| / |
Type: ["string","null"] |
| / |
The environment of the application scope that holds the value, development or production; null at the account scope.Type: ["string","null"] |
| / |
Type: array |
| / |
Type: object Required fields: ["name","base_url","credential_name","auth_header","auth_format","token_shape","application"] |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
Type: string |
| / |
Type: ["string","null"] |
| / |
Type: ["string","null"] |
| / |
Type: array |
| / |
Type: object Required fields: ["id","scope_kind","application","grants","label","created_at","expires_at","revoked_at","last_used_at"] |
| / |
Type: string |
| / |
Allowed values: ["account","application"] |
| / |
Type: ["string","null"] |
| / |
Type: array |
| / |
Type: string |
| / |
Type: ["string","null"] |
| / |
Type: string |
| / |
Type: ["string","null"] |
| / |
Type: ["string","null"] |
| / |
Type: ["string","null"] |
| / |
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}$ |
| / |
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"] |
| / |
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"] |
| / |
One entry per space of the account's own, with that space's whole export joined across its pages. Type: array |
| / |
Type: object Required fields: ["space","issues","comments","signals","asks","landings","builds","checks"] |
| / |
The space's identifier, a lower-case UUID. Type: string |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
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"] |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
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 |
| / |
Type: object Required fields: ["space","kind","application","environment","issues","comments","signals","asks"] |
| / |
The space's identifier, a lower-case UUID. Type: string |
| / |
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"] |
| / |
The application whose space this is, null for a space of the account's own. Type: ["string","null"] |
| / |
The environment one space of an application's per-environment pair serves, null for a space serving both. Type: ["string","null"] Pattern: ^(development|production)$ |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Type: array |
| / |
Type: object |
| / |
Each environment's push configuration of each application: the providers' identifiers and secret NAMES, never a value. Type: array |
| / |
Type: object Required fields: ["application","environment","apns","fcm"] Additional properties: false |
| / |
Type: string |
| / |
Type: string Allowed values: ["development","production"] |
| / |
Type: ["object","null"] Required fields: ["team_id","key_id","bundle_id","key_secret_name","environment"] Additional properties: false |
| / |
The ten-character Apple team identifier. Type: string |
| / |
The ten-character identifier of the APNs signing key. Type: string |
| / |
The app's bundle identifier, the notification's topic. Type: string |
| / |
The custody NAME of the stored .p8 signing key at this environment scope; never a value. Type: string |
| / |
Which of Apple's two gateways this environment's pushes go to. Type: string Allowed values: ["production","sandbox"] |
| / |
Type: ["object","null"] Required fields: ["project_id","service_account_secret_name"] Additional properties: false |
| / |
The Firebase project identifier. Type: string |
| / |
The custody NAME of the stored service-account JSON file at this environment scope; never a value. Type: string |
| / |
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 |
| / |
Type: object Required fields: ["name","size","created_at","kept_until"] Additional properties: false |
| / |
The picture's name. Type: string |
| / |
The picture's size in bytes. Type: integer |
| / |
When the picture was saved, as an ISO 8601 instant. Type: string |
| / |
When the picture's 7-day keep ends, as an ISO 8601 instant. Type: string |
| / |
Type: string |
| / |
$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 #
- Refusals: every refusal, by surface, with its cause and its remedy
- schemas/wire_error.schema.json
- schemas/wire_errors.json
- schemas/action_payloads.json (includes shared shapes)
- management_api_contract.md