MCP tool

Export reviewed Analytics data

sosoapi_export_analytics_report

Prepare reviewed Analytics render input for the browser or sosoapi report render. Uses the explicit reviewed dataset and version; no automatic source refresh. Render inputs can be piped to sosoapi report render --output FILE.

Read as Markdown

Profiles and transports

Profiles: full · Transports: stdio, http

Choose core or full to control which tools your client sees; this does not change its permissions. Local file upload requires stdio and is unavailable over HTTP. Set SOSOAPI_OUTPUT_SCHEMAS=1 to include output schemas in discovery. Tools return structured results with or without that setting.

Permissions and side effects

Annotations help clients describe a tool. Each call still checks the user’s authentication, role, resource access and capability grants.

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

/analytics-api/reporting/export: agent:operate · synchronous_http_response

Input fields

Required means required inside its parent object and selected branch. A required child does not make an optional parent required. Rules and field names below are copied from the contract.

Input fields
Field / branch	Type / required	Constraints
`$`	`object`Required in parent	`additionalProperties: false`
`workspace_id`	`string`Required in parent	`format: "uuid"`
`dataset`	`object`Required in parent	`additionalProperties: false`
`dataset.contractVersion`	`string`Required in parent	`enum: ["analytics-report/v1"]`
`dataset.id`	`string`Required in parent	`format: "uuid"`
`dataset.reviewedAt`	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.selection`	`object`Required in parent	`additionalProperties: false`
`dataset.selection.workspaceId`	`string`Required in parent	`format: "uuid"`
`dataset.selection.accountIds`	`array`Required in parent	`minItems: 1` `maxItems: 50`
`dataset.selection.accountIds[]`	`string`Optional / item	`format: "uuid"`
`dataset.selection.platforms`	`array`Required in parent	`minItems: 1` `maxItems: 4`
`dataset.selection.platforms[]`	`string`Optional / item	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.selection.startDate`	`string`Required in parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`dataset.selection.endDate`	`string`Required in parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`dataset.selection.timezone`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.accounts`	`array`Required in parent	`maxItems: 50`
`dataset.accounts[]`	`object`Optional / item	`additionalProperties: false`
`dataset.accounts[].id`	`string`Required in parent	`format: "uuid"`
`dataset.accounts[].workspaceId`	`string`Required in parent	`format: "uuid"`
`dataset.accounts[].platform`	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.accounts[].name`	`string`Required in parent	`maxLength: 500`
`dataset.accounts[].connectionStatus`	`string`Optional / item	`maxLength: 100`
`dataset.accounts[].healthMessage`	`string`Optional / item	`maxLength: 1000`
`dataset.posts`	`array`Required in parent	`maxItems: 1000`
`dataset.posts[]`	`object`Optional / item	`additionalProperties: false`
`dataset.posts[].social_post_id`	`string`Required in parent	`format: "uuid"`
`dataset.posts[].workspace_id`	`string`Required in parent	`format: "uuid"`
`dataset.posts[].social_account_id`	`string`Required in parent	`format: "uuid"`
`dataset.posts[].platform`	`string`Required in parent	`enum: ["instagram","facebook","threads","youtube"]`
`dataset.posts[].provider_post_id`	`string`Required in parent	`minLength: 1` `maxLength: 512`
`dataset.posts[].provider_published_at`	`string \| null`Required in parent	—
`dataset.posts[].provider_published_at`anyOf 1	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.posts[].provider_published_at`anyOf 2	`null`Required in parent	—
`dataset.posts[].content_format`	`string \| null`Required in parent	—
`dataset.posts[].content_format`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.posts[].content_format`anyOf 2	`null`Required in parent	—
`dataset.posts[].permalink`	`string \| null`Required in parent	—
`dataset.posts[].permalink`anyOf 1	`string`Required in parent	`format: "uri"` `maxLength: 2048`
`dataset.posts[].permalink`anyOf 2	`null`Required in parent	—
`dataset.posts[].provider_state`	`string`Required in parent	`enum: ["available","deleted","unavailable","unknown"]`
`dataset.posts[].first_seen_at`	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.posts[].last_seen_at`	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.posts[].scheduled_post_id`	`string \| null`Required in parent	—
`dataset.posts[].scheduled_post_id`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.posts[].scheduled_post_id`anyOf 2	`null`Required in parent	—
`dataset.posts[].provenance`	`object`Required in parent	`additionalProperties: false`
`dataset.posts[].provenance.provider`	`string`Required in parent	`enum: ["instagram","facebook","threads","youtube"]`
`dataset.posts[].provenance.source`	`string`Required in parent	`enum: ["provider_api","provider_webhook","publication_outcome","backfill"]`
`dataset.posts[].provenance.source_job_id`	`string \| null`Required in parent	—
`dataset.posts[].provenance.source_job_id`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.posts[].provenance.source_job_id`anyOf 2	`null`Required in parent	—
`dataset.posts[].provenance.provider_api_version`	`string \| null`Required in parent	—
`dataset.posts[].provenance.provider_api_version`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 200`
`dataset.posts[].provenance.provider_api_version`anyOf 2	`null`Required in parent	—
`dataset.posts[].provenance.schema_version`	`string \| null`Required in parent	—
`dataset.posts[].provenance.schema_version`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 200`
`dataset.posts[].provenance.schema_version`anyOf 2	`null`Required in parent	—
`dataset.sources`	`array`Required in parent	`maxItems: 30`
`dataset.sources[]`	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].accountId`	`string`Required in parent	`format: "uuid"`
`dataset.sources[].platform`	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.sources[].resourceKind`	`string`Required in parent	`enum: ["account","post"]`
`dataset.sources[].providerResourceId`	`string \| null`Required in parent	—
`dataset.sources[].providerResourceId`anyOf 1	`string`Required in parent	`maxLength: 512`
`dataset.sources[].providerResourceId`anyOf 2	`null`Required in parent	—
`dataset.sources[].requestId`	`string \| null`Required in parent	—
`dataset.sources[].requestId`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.sources[].requestId`anyOf 2	`null`Required in parent	—
`dataset.sources[].status`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.sources[].reason`	`string \| null`Required in parent	—
`dataset.sources[].reason`anyOf 1	`string`Required in parent	`maxLength: 8000`
`dataset.sources[].reason`anyOf 2	`null`Required in parent	—
`dataset.sources[].envelope`	`object \| null`Required in parent	—
`dataset.sources[].envelope`anyOf 1	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].envelope.contract_version`anyOf 1	`string`Required in parent	`enum: ["provider-insights/v1"]`
`dataset.sources[].envelope.request_id`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.sources[].envelope.platform`anyOf 1	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.sources[].envelope.resource`anyOf 1	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].envelope.resource.kind`anyOf 1	`string`Required in parent	`enum: ["account","post"]`
`dataset.sources[].envelope.resource.social_account_id`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.sources[].envelope.resource.provider_resource_id`anyOf 1	`string \| null`Required in parent	—
`dataset.sources[].envelope.provider_api_version`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.sources[].envelope.fetched_at`anyOf 1	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.sources[].envelope.status`anyOf 1	`string`Required in parent	`enum: ["available","partial","unavailable"]`
`dataset.sources[].envelope.availability`anyOf 1	`array`Required in parent	`minItems: 1` `maxItems: 64`
`dataset.sources[].envelope.availability[]`anyOf 1	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].envelope.availability[].scope`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 200`
`dataset.sources[].envelope.availability[].status`anyOf 1	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed"]`
`dataset.sources[].envelope.availability[].reason`anyOf 1	`string`Optional / item	`minLength: 1` `maxLength: 2000`
`dataset.sources[].envelope.availability[].diagnostics`anyOf 1	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].envelope.availability[].diagnostics.http_status`anyOf 1	`integer`Required in parent	`minimum: 0` `maximum: 599`
`dataset.sources[].envelope.availability[].diagnostics.failed_step`anyOf 1	`string`Optional / item	`minLength: 1` `maxLength: 200`
`dataset.sources[].envelope.availability[].diagnostics.provider_code`anyOf 1	`number \| string`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_code`anyOf 1 / anyOf 1	`number`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_code`anyOf 1 / anyOf 2	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.provider_subcode`anyOf 1	`number \| string`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_subcode`anyOf 1 / anyOf 1	`number`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_subcode`anyOf 1 / anyOf 2	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.provider_type`anyOf 1	`string`Optional / item	`maxLength: 200`
`dataset.sources[].envelope.availability[].diagnostics.is_transient`anyOf 1	`boolean`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_request_id`anyOf 1	`string`Optional / item	`maxLength: 200`
`dataset.sources[].envelope.availability[].diagnostics.access`anyOf 1	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].envelope.availability[].diagnostics.access.login_mode`anyOf 1	`string`Required in parent	`enum: ["instagram_login","facebook_login","threads_user"]`
`dataset.sources[].envelope.availability[].diagnostics.access.provider_host`anyOf 1	`string`Required in parent	`maxLength: 200`
`dataset.sources[].envelope.availability[].diagnostics.access.required_permissions`anyOf 1	`array`Required in parent	`maxItems: 16`
`dataset.sources[].envelope.availability[].diagnostics.access.required_permissions[]`anyOf 1	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.access.current_connection_policy_permissions`anyOf 1	`array`Required in parent	`maxItems: 16`
`dataset.sources[].envelope.availability[].diagnostics.access.current_connection_policy_permissions[]`anyOf 1	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions`anyOf 1	`array \| null`Required in parent	—
`dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions`anyOf 1 / anyOf 1	`array`Required in parent	`maxItems: 128`
`dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions[]`anyOf 1 / anyOf 1	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions`anyOf 1 / anyOf 2	`null`Required in parent	—
`dataset.sources[].envelope.availability[].diagnostics.access.grant_evidence`anyOf 1	`string`Required in parent	`enum: ["exact","unknown"]`
`dataset.sources[].envelope.availability[].diagnostics.access.permission_state`anyOf 1	`string`Required in parent	`enum: ["granted","missing","unknown"]`
`dataset.sources[].envelope.availability[].diagnostics.access.grant_observed_at`anyOf 1	`string`Optional / item	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.sources[].envelope.availability[].diagnostics.access.app_access`anyOf 1	`string`Required in parent	`enum: ["unverified"]`
`dataset.sources[].envelope.availability[].diagnostics.access.next_step`anyOf 1	`string`Required in parent	`maxLength: 1500`
`dataset.sources[].envelope.provider_data`anyOf 1	`any JSON value \| null`Required in parent	—
`dataset.sources[].envelope.provider_data`anyOf 1 / anyOf 1	`any JSON value`Required in parent	—
`dataset.sources[].envelope.provider_data`anyOf 1 / anyOf 2	`null`Required in parent	—
`dataset.sources[].envelope.requested_date_range`anyOf 1	`object \| null`Required in parent	—
`dataset.sources[].envelope.requested_date_range`anyOf 1 / anyOf 1	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].envelope.requested_date_range.start_date`anyOf 1 / anyOf 1	`string`Required in parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`dataset.sources[].envelope.requested_date_range.end_date`anyOf 1 / anyOf 1	`string`Required in parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`dataset.sources[].envelope.requested_date_range`anyOf 1 / anyOf 2	`null`Required in parent	—
`dataset.sources[].envelope.cache`anyOf 1	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].envelope.cache.authoritative`anyOf 1	`boolean`Required in parent	`enum: [false]`
`dataset.sources[].envelope.cache.status`anyOf 1	`string`Required in parent	`enum: ["stored","hit","bypassed"]`
`dataset.sources[].envelope.cache.expires_at`anyOf 1	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.sources[].envelope`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics`	`array`Required in parent	`maxItems: 5000`
`dataset.sources[].metrics[]`	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].metrics[].key`	`string`Required in parent	`minLength: 1` `maxLength: 150`
`dataset.sources[].metrics[].definition`	`string`Required in parent	`minLength: 1` `maxLength: 1000`
`dataset.sources[].metrics[].unit`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.sources[].metrics[].grain`	`string`Required in parent	`enum: ["post","account"]`
`dataset.sources[].metrics[].value`	`number \| null`Required in parent	—
`dataset.sources[].metrics[].availability`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.sources[].metrics[].reason`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].reason`anyOf 1	`string`Required in parent	`maxLength: 4000`
`dataset.sources[].metrics[].reason`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].measurement`	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].metrics[].measurement.kind`	`string`Required in parent	`enum: ["lifetime","snapshot","period","unknown"]`
`dataset.sources[].metrics[].measurement.period`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].measurement.period`anyOf 1	`string`Required in parent	`maxLength: 100`
`dataset.sources[].metrics[].measurement.period`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].measurement.start`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].measurement.start`anyOf 1	`string`Required in parent	`maxLength: 100`
`dataset.sources[].metrics[].measurement.start`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].measurement.end`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].measurement.end`anyOf 1	`string`Required in parent	`maxLength: 100`
`dataset.sources[].metrics[].measurement.end`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].measurement.timezone`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].measurement.timezone`anyOf 1	`string`Required in parent	`maxLength: 100`
`dataset.sources[].metrics[].measurement.timezone`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].sourcePath`	`string`Required in parent	`minLength: 1` `maxLength: 2000`
`dataset.coverage`	`object`Required in parent	`additionalProperties: false`
`dataset.coverage.population`	`string`Required in parent	`enum: ["discovered_posts"]`
`dataset.coverage.postsComplete`	`boolean`Required in parent	—
`dataset.coverage.nextCursor`	`string \| null`Required in parent	—
`dataset.coverage.nextCursor`anyOf 1	`string`Required in parent	`maxLength: 16384`
`dataset.coverage.nextCursor`anyOf 2	`null`Required in parent	—
`dataset.coverage.postLimit`	`integer`Required in parent	`minimum: 0` `maximum: 1000`
`dataset.coverage.postInsightsLimit`	`integer`Required in parent	`minimum: 0` `maximum: 20`
`dataset.coverage.omittedPostInsights`	`integer`Required in parent	`minimum: 0` `maximum: 9007199254740991`
`dataset.coverage.notes`	`array`Required in parent	`maxItems: 50`
`dataset.coverage.notes[]`	`string`Optional / item	`maxLength: 2000`
`dataset.customMetrics`	`array`Required in parent	`maxItems: 50`
`dataset.customMetrics[]`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].id`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].name`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].version`	`integer`Required in parent	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`dataset.customMetrics[].expression`	`string`Required in parent	`minLength: 1` `maxLength: 1000`
`dataset.customMetrics[].definition`	`string`Required in parent	`maxLength: 1000`
`dataset.customMetrics[].unit`	`string`Required in parent	`maxLength: 100`
`dataset.customMetrics[].grain`	`string`Required in parent	`enum: ["post","account","compatible_sum"]`
`dataset.customMetrics[].rounding`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].rounding.decimalPlaces`	`integer`Required in parent	`minimum: 0` `maximum: 8`
`dataset.customMetrics[].rounding.mode`	`string`Required in parent	`enum: ["half_away_from_zero"]`
`dataset.customMetrics[].inputs`	`array`Required in parent	`maxItems: 5000`
`dataset.customMetrics[].inputs[]`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].inputs[].requestId`	`string \| null`Required in parent	—
`dataset.customMetrics[].inputs[].requestId`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].inputs[].requestId`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].inputs[].sourcePath`	`string`Required in parent	`maxLength: 2000`
`dataset.customMetrics[].inputs[].value`	`number \| null`Required in parent	—
`dataset.customMetrics[].inputs[].availability`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.customMetrics[].value`	`number \| null`Required in parent	—
`dataset.customMetrics[].availability`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.customMetrics[].reason`	`string \| null`Required in parent	—
`dataset.customMetrics[].reason`anyOf 1	`string`Required in parent	`maxLength: 4000`
`dataset.customMetrics[].reason`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].formula`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].formula.contractVersion`	`string`Required in parent	`enum: ["analytics-metric/v1"]`
`dataset.customMetrics[].formula.id`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].formula.workspaceId`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].formula.name`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].formula.version`	`integer`Required in parent	`minimum: 1` `maximum: 1000000`
`dataset.customMetrics[].formula.expression`	`string`Required in parent	`minLength: 1` `maxLength: 1000`
`dataset.customMetrics[].formula.fields`	`array`Required in parent	`maxItems: 32`
`dataset.customMetrics[].formula.fields[]`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].formula.fields[].identifier`	`string`Required in parent	`pattern: "^[a-z][a-z0-9_]{0,63}$"`
`dataset.customMetrics[].formula.fields[].selector`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].formula.fields[].selector.platform`	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.customMetrics[].formula.fields[].selector.key`	`string`Required in parent	`pattern: "^[A-Za-z][A-Za-z0-9_]{0,100}$"`
`dataset.customMetrics[].formula.fields[].selector.definition`	`string`Required in parent	`minLength: 1` `maxLength: 500`
`dataset.customMetrics[].formula.fields[].selector.unit`	`string`Required in parent	`enum: ["count","seconds","minutes","percent","ratio"]`
`dataset.customMetrics[].formula.fields[].selector.grain`	`string`Required in parent	`enum: ["post","account"]`
`dataset.customMetrics[].formula.fields[].selector.measurementKind`	`string`Required in parent	`enum: ["lifetime","snapshot","period","unknown"]`
`dataset.customMetrics[].formula.fields[].selector.nativePeriod`	`string \| null`Required in parent	—
`dataset.customMetrics[].formula.fields[].selector.nativePeriod`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].formula.fields[].selector.nativePeriod`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].formula.fields[].selector.timezone`	`string \| null`Required in parent	—
`dataset.customMetrics[].formula.fields[].selector.timezone`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].formula.fields[].selector.timezone`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].formula.fields[].aggregation`	`string`Required in parent	`enum: ["single","sum"]`
`dataset.customMetrics[].formula.rounding`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].formula.rounding.decimalPlaces`	`integer`Required in parent	`minimum: 0` `maximum: 8`
`dataset.customMetrics[].formula.rounding.mode`	`string`Required in parent	`enum: ["half_away_from_zero"]`
`dataset.customMetrics[].calculation`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].calculation.contractVersion`	`string`Required in parent	`enum: ["analytics-metric/v1"]`
`dataset.customMetrics[].calculation.workspaceId`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].calculation.datasetId`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].calculation.formulaId`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].calculation.name`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].calculation.version`	`integer`Required in parent	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`dataset.customMetrics[].calculation.expression`	`string`Required in parent	`maxLength: 1000`
`dataset.customMetrics[].calculation.rounding`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].calculation.rounding.decimalPlaces`	`integer`Required in parent	`minimum: 0` `maximum: 8`
`dataset.customMetrics[].calculation.rounding.mode`	`string`Required in parent	`enum: ["half_away_from_zero"]`
`dataset.customMetrics[].calculation.value`	`number \| null`Required in parent	—
`dataset.customMetrics[].calculation.unit`	`string`Required in parent	`minLength: 1` `maxLength: 200`
`dataset.customMetrics[].calculation.status`	`string`Required in parent	`enum: ["available","not_returned"]`
`dataset.customMetrics[].calculation.code`	`string`Required in parent	`enum: ["ok","invalid_expression","missing_input","incompatible_input","zero_denominator","numeric_limit","workspace_mismatch","ambiguous_input","unknown_exclusion"]`
`dataset.customMetrics[].calculation.reason`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.reason`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 500`
`dataset.customMetrics[].calculation.reason`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.excludedInputIds`	`array`Required in parent	`maxItems: 5000`
`dataset.customMetrics[].calculation.excludedInputIds[]`	`string`Optional / item	`minLength: 1` `maxLength: 1500`
`dataset.customMetrics[].calculation.inputs`	`array`Required in parent	`maxItems: 5000`
`dataset.customMetrics[].calculation.inputs[]`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].calculation.inputs[].inputId`	`string`Required in parent	`minLength: 1` `maxLength: 1500`
`dataset.customMetrics[].calculation.inputs[].selector`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].calculation.inputs[].selector.platform`	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.customMetrics[].calculation.inputs[].selector.key`	`string`Required in parent	`pattern: "^[A-Za-z][A-Za-z0-9_]{0,100}$"`
`dataset.customMetrics[].calculation.inputs[].selector.definition`	`string`Required in parent	`minLength: 1` `maxLength: 500`
`dataset.customMetrics[].calculation.inputs[].selector.unit`	`string`Required in parent	`enum: ["count","seconds","minutes","percent","ratio"]`
`dataset.customMetrics[].calculation.inputs[].selector.grain`	`string`Required in parent	`enum: ["post","account"]`
`dataset.customMetrics[].calculation.inputs[].selector.measurementKind`	`string`Required in parent	`enum: ["lifetime","snapshot","period","unknown"]`
`dataset.customMetrics[].calculation.inputs[].selector.nativePeriod`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].selector.nativePeriod`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].calculation.inputs[].selector.nativePeriod`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].selector.timezone`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].selector.timezone`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].calculation.inputs[].selector.timezone`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].value`	`number \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].availability`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.customMetrics[].calculation.inputs[].reason`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].reason`anyOf 1	`string`Required in parent	`maxLength: 8000`
`dataset.customMetrics[].calculation.inputs[].reason`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].calculation.inputs[].measurement.kind`	`string`Required in parent	`enum: ["lifetime","snapshot","period","unknown"]`
`dataset.customMetrics[].calculation.inputs[].measurement.period`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.period`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].calculation.inputs[].measurement.period`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.start`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.start`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].calculation.inputs[].measurement.start`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.end`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.end`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].calculation.inputs[].measurement.end`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.timezone`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.timezone`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].calculation.inputs[].measurement.timezone`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].requestId`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].requestId`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].calculation.inputs[].requestId`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].sourcePath`	`string`Required in parent	`minLength: 1` `maxLength: 1000`
`dataset.customMetrics[].calculation.inputs[].accountId`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].calculation.inputs[].providerResourceId`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].providerResourceId`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 512`
`dataset.customMetrics[].calculation.inputs[].providerResourceId`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].fetchedAt`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].fetchedAt`anyOf 1	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.customMetrics[].calculation.inputs[].fetchedAt`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].identifier`	`string`Required in parent	`pattern: "^[a-z][a-z0-9_]{0,63}$"`
`dataset.customMetrics[].calculation.inputs[].included`	`boolean`Required in parent	—
`format`	`string`Required in parent	`enum: ["csv","xlsx","pdf"]`
`locale`	`string`Optional / item	`enum: ["en","zh-Hant"]`
`title`	`string`Optional / item	`maxLength: 160`

Complete JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "dataset": {
      "type": "object",
      "properties": {
        "contractVersion": {
          "type": "string",
          "enum": [
            "analytics-report/v1"
          ]
        },
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "reviewedAt": {
          "type": "string",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
          "format": "date-time"
        },
        "selection": {
          "type": "object",
          "properties": {
            "workspaceId": {
              "type": "string",
              "format": "uuid"
            },
            "accountIds": {
              "minItems": 1,
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid"
              }
            },
            "platforms": {
              "minItems": 1,
              "maxItems": 4,
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "facebook",
                  "instagram",
                  "threads",
                  "youtube"
                ]
              }
            },
            "startDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "endDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "timezone": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          },
          "required": [
            "workspaceId",
            "accountIds",
            "platforms",
            "startDate",
            "endDate",
            "timezone"
          ],
          "additionalProperties": false
        },
        "accounts": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "workspaceId": {
                "type": "string",
                "format": "uuid"
              },
              "platform": {
                "type": "string",
                "enum": [
                  "facebook",
                  "instagram",
                  "threads",
                  "youtube"
                ]
              },
              "name": {
                "type": "string",
                "maxLength": 500
              },
              "connectionStatus": {
                "type": "string",
                "maxLength": 100
              },
              "healthMessage": {
                "type": "string",
                "maxLength": 1000
              }
            },
            "required": [
              "id",
              "workspaceId",
              "platform",
              "name"
            ],
            "additionalProperties": false
          }
        },
        "posts": {
          "maxItems": 1000,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "social_post_id": {
                "type": "string",
                "format": "uuid"
              },
              "workspace_id": {
                "type": "string",
                "format": "uuid"
              },
              "social_account_id": {
                "type": "string",
                "format": "uuid"
              },
              "platform": {
                "type": "string",
                "enum": [
                  "instagram",
                  "facebook",
                  "threads",
                  "youtube"
                ]
              },
              "provider_post_id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 512
              },
              "provider_published_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "content_format": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "permalink": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provider_state": {
                "type": "string",
                "enum": [
                  "available",
                  "deleted",
                  "unavailable",
                  "unknown"
                ]
              },
              "first_seen_at": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                "format": "date-time"
              },
              "last_seen_at": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                "format": "date-time"
              },
              "scheduled_post_id": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uuid"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provenance": {
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "enum": [
                      "instagram",
                      "facebook",
                      "threads",
                      "youtube"
                    ]
                  },
                  "source": {
                    "type": "string",
                    "enum": [
                      "provider_api",
                      "provider_webhook",
                      "publication_outcome",
                      "backfill"
                    ]
                  },
                  "source_job_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "provider_api_version": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "schema_version": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "provider",
                  "source",
                  "source_job_id",
                  "provider_api_version",
                  "schema_version"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "social_post_id",
              "workspace_id",
              "social_account_id",
              "platform",
              "provider_post_id",
              "provider_published_at",
              "content_format",
              "permalink",
              "provider_state",
              "first_seen_at",
              "last_seen_at",
              "scheduled_post_id",
              "provenance"
            ],
            "additionalProperties": false
          }
        },
        "sources": {
          "maxItems": 30,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "accountId": {
                "type": "string",
                "format": "uuid"
              },
              "platform": {
                "type": "string",
                "enum": [
                  "facebook",
                  "instagram",
                  "threads",
                  "youtube"
                ]
              },
              "resourceKind": {
                "type": "string",
                "enum": [
                  "account",
                  "post"
                ]
              },
              "providerResourceId": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 512
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "requestId": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uuid"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "available",
                  "partial",
                  "not_returned",
                  "unsupported",
                  "permission_required",
                  "threshold_not_met",
                  "no_data",
                  "failed",
                  "pending",
                  "stale"
                ]
              },
              "reason": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 8000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "envelope": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "contract_version": {
                        "type": "string",
                        "enum": [
                          "provider-insights/v1"
                        ]
                      },
                      "request_id": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "platform": {
                        "type": "string",
                        "enum": [
                          "facebook",
                          "instagram",
                          "threads",
                          "youtube"
                        ]
                      },
                      "resource": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "account",
                              "post"
                            ]
                          },
                          "social_account_id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "provider_resource_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "kind",
                          "social_account_id",
                          "provider_resource_id"
                        ],
                        "additionalProperties": false
                      },
                      "provider_api_version": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "fetched_at": {
                        "type": "string",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                        "format": "date-time"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "available",
                          "partial",
                          "unavailable"
                        ]
                      },
                      "availability": {
                        "minItems": 1,
                        "maxItems": 64,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "scope": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "available",
                                "partial",
                                "not_returned",
                                "unsupported",
                                "permission_required",
                                "threshold_not_met",
                                "no_data",
                                "failed"
                              ]
                            },
                            "reason": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 2000
                            },
                            "diagnostics": {
                              "type": "object",
                              "properties": {
                                "http_status": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 599
                                },
                                "failed_step": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                "provider_code": {
                                  "anyOf": [
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "string",
                                      "maxLength": 100
                                    }
                                  ]
                                },
                                "provider_subcode": {
                                  "anyOf": [
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "string",
                                      "maxLength": 100
                                    }
                                  ]
                                },
                                "provider_type": {
                                  "type": "string",
                                  "maxLength": 200
                                },
                                "is_transient": {
                                  "type": "boolean"
                                },
                                "provider_request_id": {
                                  "type": "string",
                                  "maxLength": 200
                                },
                                "access": {
                                  "type": "object",
                                  "properties": {
                                    "login_mode": {
                                      "type": "string",
                                      "enum": [
                                        "instagram_login",
                                        "facebook_login",
                                        "threads_user"
                                      ]
                                    },
                                    "provider_host": {
                                      "type": "string",
                                      "maxLength": 200
                                    },
                                    "required_permissions": {
                                      "maxItems": 16,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 100
                                      }
                                    },
                                    "current_connection_policy_permissions": {
                                      "maxItems": 16,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 100
                                      }
                                    },
                                    "granted_permissions": {
                                      "anyOf": [
                                        {
                                          "maxItems": 128,
                                          "type": "array",
                                          "items": {
                                            "type": "string",
                                            "maxLength": 100
                                          }
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "grant_evidence": {
                                      "type": "string",
                                      "enum": [
                                        "exact",
                                        "unknown"
                                      ]
                                    },
                                    "permission_state": {
                                      "type": "string",
                                      "enum": [
                                        "granted",
                                        "missing",
                                        "unknown"
                                      ]
                                    },
                                    "grant_observed_at": {
                                      "type": "string",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "format": "date-time"
                                    },
                                    "app_access": {
                                      "type": "string",
                                      "enum": [
                                        "unverified"
                                      ]
                                    },
                                    "next_step": {
                                      "type": "string",
                                      "maxLength": 1500
                                    }
                                  },
                                  "required": [
                                    "login_mode",
                                    "provider_host",
                                    "required_permissions",
                                    "current_connection_policy_permissions",
                                    "granted_permissions",
                                    "grant_evidence",
                                    "permission_state",
                                    "app_access",
                                    "next_step"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "required": [
                                "http_status"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "scope",
                            "status"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "provider_data": {
                        "anyOf": [
                          {},
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "requested_date_range": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "start_date": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              },
                              "end_date": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              }
                            },
                            "required": [
                              "start_date",
                              "end_date"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "cache": {
                        "type": "object",
                        "properties": {
                          "authoritative": {
                            "type": "boolean",
                            "enum": [
                              false
                            ]
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "stored",
                              "hit",
                              "bypassed"
                            ]
                          },
                          "expires_at": {
                            "type": "string",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                            "format": "date-time"
                          }
                        },
                        "required": [
                          "authoritative",
                          "status",
                          "expires_at"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "contract_version",
                      "request_id",
                      "platform",
                      "resource",
                      "provider_api_version",
                      "fetched_at",
                      "status",
                      "availability",
                      "provider_data",
                      "requested_date_range",
                      "cache"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "metrics": {
                "maxItems": 5000,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 150
                    },
                    "definition": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1000
                    },
                    "unit": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "grain": {
                      "type": "string",
                      "enum": [
                        "post",
                        "account"
                      ]
                    },
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "availability": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "not_returned",
                        "unsupported",
                        "permission_required",
                        "threshold_not_met",
                        "no_data",
                        "failed",
                        "pending",
                        "stale"
                      ]
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 4000
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "measurement": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "lifetime",
                            "snapshot",
                            "period",
                            "unknown"
                          ]
                        },
                        "period": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "start": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "end": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "timezone": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "period",
                        "start",
                        "end",
                        "timezone"
                      ],
                      "additionalProperties": false
                    },
                    "sourcePath": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 2000
                    }
                  },
                  "required": [
                    "key",
                    "definition",
                    "unit",
                    "grain",
                    "value",
                    "availability",
                    "reason",
                    "measurement",
                    "sourcePath"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "accountId",
              "platform",
              "resourceKind",
              "providerResourceId",
              "requestId",
              "status",
              "reason",
              "envelope",
              "metrics"
            ],
            "additionalProperties": false
          }
        },
        "coverage": {
          "type": "object",
          "properties": {
            "population": {
              "type": "string",
              "enum": [
                "discovered_posts"
              ]
            },
            "postsComplete": {
              "type": "boolean"
            },
            "nextCursor": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 16384
                },
                {
                  "type": "null"
                }
              ]
            },
            "postLimit": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000
            },
            "postInsightsLimit": {
              "type": "integer",
              "minimum": 0,
              "maximum": 20
            },
            "omittedPostInsights": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "notes": {
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 2000
              }
            }
          },
          "required": [
            "population",
            "postsComplete",
            "nextCursor",
            "postLimit",
            "postInsightsLimit",
            "omittedPostInsights",
            "notes"
          ],
          "additionalProperties": false
        },
        "customMetrics": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "version": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "expression": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000
              },
              "definition": {
                "type": "string",
                "maxLength": 1000
              },
              "unit": {
                "type": "string",
                "maxLength": 100
              },
              "grain": {
                "type": "string",
                "enum": [
                  "post",
                  "account",
                  "compatible_sum"
                ]
              },
              "rounding": {
                "type": "object",
                "properties": {
                  "decimalPlaces": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 8
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "half_away_from_zero"
                    ]
                  }
                },
                "required": [
                  "decimalPlaces",
                  "mode"
                ],
                "additionalProperties": false
              },
              "inputs": {
                "maxItems": 5000,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "requestId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "sourcePath": {
                      "type": "string",
                      "maxLength": 2000
                    },
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "availability": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "not_returned",
                        "unsupported",
                        "permission_required",
                        "threshold_not_met",
                        "no_data",
                        "failed",
                        "pending",
                        "stale"
                      ]
                    }
                  },
                  "required": [
                    "requestId",
                    "sourcePath",
                    "value",
                    "availability"
                  ],
                  "additionalProperties": false
                }
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "availability": {
                "type": "string",
                "enum": [
                  "available",
                  "partial",
                  "not_returned",
                  "unsupported",
                  "permission_required",
                  "threshold_not_met",
                  "no_data",
                  "failed",
                  "pending",
                  "stale"
                ]
              },
              "reason": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 4000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "formula": {
                "type": "object",
                "properties": {
                  "contractVersion": {
                    "type": "string",
                    "enum": [
                      "analytics-metric/v1"
                    ]
                  },
                  "id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "version": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000
                  },
                  "expression": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "fields": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "identifier": {
                          "type": "string",
                          "pattern": "^[a-z][a-z0-9_]{0,63}$"
                        },
                        "selector": {
                          "type": "object",
                          "properties": {
                            "platform": {
                              "type": "string",
                              "enum": [
                                "facebook",
                                "instagram",
                                "threads",
                                "youtube"
                              ]
                            },
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$"
                            },
                            "definition": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 500
                            },
                            "unit": {
                              "type": "string",
                              "enum": [
                                "count",
                                "seconds",
                                "minutes",
                                "percent",
                                "ratio"
                              ]
                            },
                            "grain": {
                              "type": "string",
                              "enum": [
                                "post",
                                "account"
                              ]
                            },
                            "measurementKind": {
                              "type": "string",
                              "enum": [
                                "lifetime",
                                "snapshot",
                                "period",
                                "unknown"
                              ]
                            },
                            "nativePeriod": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "timezone": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "platform",
                            "key",
                            "definition",
                            "unit",
                            "grain",
                            "measurementKind",
                            "nativePeriod",
                            "timezone"
                          ],
                          "additionalProperties": false
                        },
                        "aggregation": {
                          "type": "string",
                          "enum": [
                            "single",
                            "sum"
                          ]
                        }
                      },
                      "required": [
                        "identifier",
                        "selector",
                        "aggregation"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "rounding": {
                    "type": "object",
                    "properties": {
                      "decimalPlaces": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 8
                      },
                      "mode": {
                        "type": "string",
                        "enum": [
                          "half_away_from_zero"
                        ]
                      }
                    },
                    "required": [
                      "decimalPlaces",
                      "mode"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "contractVersion",
                  "id",
                  "workspaceId",
                  "name",
                  "version",
                  "expression",
                  "fields",
                  "rounding"
                ],
                "additionalProperties": false
              },
              "calculation": {
                "type": "object",
                "properties": {
                  "contractVersion": {
                    "type": "string",
                    "enum": [
                      "analytics-metric/v1"
                    ]
                  },
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "datasetId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "formulaId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "version": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  "expression": {
                    "type": "string",
                    "maxLength": 1000
                  },
                  "rounding": {
                    "type": "object",
                    "properties": {
                      "decimalPlaces": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 8
                      },
                      "mode": {
                        "type": "string",
                        "enum": [
                          "half_away_from_zero"
                        ]
                      }
                    },
                    "required": [
                      "decimalPlaces",
                      "mode"
                    ],
                    "additionalProperties": false
                  },
                  "value": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "available",
                      "not_returned"
                    ]
                  },
                  "code": {
                    "type": "string",
                    "enum": [
                      "ok",
                      "invalid_expression",
                      "missing_input",
                      "incompatible_input",
                      "zero_denominator",
                      "numeric_limit",
                      "workspace_mismatch",
                      "ambiguous_input",
                      "unknown_exclusion"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 500
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "excludedInputIds": {
                    "maxItems": 5000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1500
                    }
                  },
                  "inputs": {
                    "maxItems": 5000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "inputId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1500
                        },
                        "selector": {
                          "type": "object",
                          "properties": {
                            "platform": {
                              "type": "string",
                              "enum": [
                                "facebook",
                                "instagram",
                                "threads",
                                "youtube"
                              ]
                            },
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$"
                            },
                            "definition": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 500
                            },
                            "unit": {
                              "type": "string",
                              "enum": [
                                "count",
                                "seconds",
                                "minutes",
                                "percent",
                                "ratio"
                              ]
                            },
                            "grain": {
                              "type": "string",
                              "enum": [
                                "post",
                                "account"
                              ]
                            },
                            "measurementKind": {
                              "type": "string",
                              "enum": [
                                "lifetime",
                                "snapshot",
                                "period",
                                "unknown"
                              ]
                            },
                            "nativePeriod": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "timezone": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "platform",
                            "key",
                            "definition",
                            "unit",
                            "grain",
                            "measurementKind",
                            "nativePeriod",
                            "timezone"
                          ],
                          "additionalProperties": false
                        },
                        "value": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "availability": {
                          "type": "string",
                          "enum": [
                            "available",
                            "partial",
                            "not_returned",
                            "unsupported",
                            "permission_required",
                            "threshold_not_met",
                            "no_data",
                            "failed",
                            "pending",
                            "stale"
                          ]
                        },
                        "reason": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 8000
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "measurement": {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "enum": [
                                "lifetime",
                                "snapshot",
                                "period",
                                "unknown"
                              ]
                            },
                            "period": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "start": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "end": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "timezone": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "kind",
                            "period",
                            "start",
                            "end",
                            "timezone"
                          ],
                          "additionalProperties": false
                        },
                        "requestId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uuid"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "sourcePath": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1000
                        },
                        "accountId": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "providerResourceId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 512
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "fetchedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "identifier": {
                          "type": "string",
                          "pattern": "^[a-z][a-z0-9_]{0,63}$"
                        },
                        "included": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "inputId",
                        "selector",
                        "value",
                        "availability",
                        "reason",
                        "measurement",
                        "requestId",
                        "sourcePath",
                        "accountId",
                        "providerResourceId",
                        "fetchedAt",
                        "identifier",
                        "included"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "contractVersion",
                  "workspaceId",
                  "datasetId",
                  "formulaId",
                  "name",
                  "version",
                  "expression",
                  "rounding",
                  "value",
                  "unit",
                  "status",
                  "code",
                  "reason",
                  "excludedInputIds",
                  "inputs"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "id",
              "name",
              "version",
              "expression",
              "definition",
              "unit",
              "grain",
              "rounding",
              "inputs",
              "value",
              "availability",
              "reason"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "contractVersion",
        "id",
        "reviewedAt",
        "selection",
        "accounts",
        "posts",
        "sources",
        "coverage",
        "customMetrics"
      ],
      "additionalProperties": false
    },
    "format": {
      "type": "string",
      "enum": [
        "csv",
        "xlsx",
        "pdf"
      ]
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "zh-Hant"
      ]
    },
    "title": {
      "type": "string",
      "maxLength": 160
    }
  },
  "required": [
    "workspace_id",
    "dataset",
    "format"
  ],
  "additionalProperties": false
}

Structured output

This schema describes structuredContent in a successful tool result. The MCP response also includes content and may set isError when a call fails. For publishing, read the post’s final result rather than treating an accepted request or text response as confirmation. The linked API operation explains permissions and retry rules.

Required means required inside its parent object and selected branch. A required child does not make an optional parent required. Rules and field names below are copied from the contract.

Structured output
Field / branch	Type / required	Constraints
`$`	`object`Required in parent	`additionalProperties: false`
`contract_version`	`string`Required in parent	`const: "analytics-render-input/v1"`
`kind`	`string`Required in parent	`const: "standard"`
`dataset`	`object`Required in parent	`additionalProperties: false`
`dataset.contractVersion`	`string`Required in parent	`const: "analytics-report/v1"`
`dataset.id`	`string`Required in parent	`format: "uuid"`
`dataset.reviewedAt`	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.selection`	`object`Required in parent	`additionalProperties: false`
`dataset.selection.workspaceId`	`string`Required in parent	`format: "uuid"`
`dataset.selection.accountIds`	`array`Required in parent	`minItems: 1` `maxItems: 50`
`dataset.selection.accountIds[]`	`string`Optional / item	`format: "uuid"`
`dataset.selection.platforms`	`array`Required in parent	`minItems: 1` `maxItems: 4`
`dataset.selection.platforms[]`	`string`Optional / item	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.selection.startDate`	`string`Required in parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`dataset.selection.endDate`	`string`Required in parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`dataset.selection.timezone`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.accounts`	`array`Required in parent	`maxItems: 50`
`dataset.accounts[]`	`object`Optional / item	`additionalProperties: false`
`dataset.accounts[].id`	`string`Required in parent	`format: "uuid"`
`dataset.accounts[].workspaceId`	`string`Required in parent	`format: "uuid"`
`dataset.accounts[].platform`	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.accounts[].name`	`string`Required in parent	`maxLength: 500`
`dataset.accounts[].connectionStatus`	`string`Optional / item	`maxLength: 100`
`dataset.accounts[].healthMessage`	`string`Optional / item	`maxLength: 1000`
`dataset.posts`	`array`Required in parent	`maxItems: 1000`
`dataset.posts[]`	`object`Optional / item	`additionalProperties: false`
`dataset.posts[].social_post_id`	`string`Required in parent	`format: "uuid"`
`dataset.posts[].workspace_id`	`string`Required in parent	`format: "uuid"`
`dataset.posts[].social_account_id`	`string`Required in parent	`format: "uuid"`
`dataset.posts[].platform`	`string`Required in parent	`enum: ["instagram","facebook","threads","youtube"]`
`dataset.posts[].provider_post_id`	`string`Required in parent	`minLength: 1` `maxLength: 512`
`dataset.posts[].provider_published_at`	`string \| null`Required in parent	—
`dataset.posts[].provider_published_at`anyOf 1	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.posts[].provider_published_at`anyOf 2	`null`Required in parent	—
`dataset.posts[].content_format`	`string \| null`Required in parent	—
`dataset.posts[].content_format`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.posts[].content_format`anyOf 2	`null`Required in parent	—
`dataset.posts[].permalink`	`string \| null`Required in parent	—
`dataset.posts[].permalink`anyOf 1	`string`Required in parent	`format: "uri"` `maxLength: 2048`
`dataset.posts[].permalink`anyOf 2	`null`Required in parent	—
`dataset.posts[].provider_state`	`string`Required in parent	`enum: ["available","deleted","unavailable","unknown"]`
`dataset.posts[].first_seen_at`	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.posts[].last_seen_at`	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.posts[].scheduled_post_id`	`string \| null`Required in parent	—
`dataset.posts[].scheduled_post_id`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.posts[].scheduled_post_id`anyOf 2	`null`Required in parent	—
`dataset.posts[].provenance`	`object`Required in parent	`additionalProperties: false`
`dataset.posts[].provenance.provider`	`string`Required in parent	`enum: ["instagram","facebook","threads","youtube"]`
`dataset.posts[].provenance.source`	`string`Required in parent	`enum: ["provider_api","provider_webhook","publication_outcome","backfill"]`
`dataset.posts[].provenance.source_job_id`	`string \| null`Required in parent	—
`dataset.posts[].provenance.source_job_id`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.posts[].provenance.source_job_id`anyOf 2	`null`Required in parent	—
`dataset.posts[].provenance.provider_api_version`	`string \| null`Required in parent	—
`dataset.posts[].provenance.provider_api_version`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 200`
`dataset.posts[].provenance.provider_api_version`anyOf 2	`null`Required in parent	—
`dataset.posts[].provenance.schema_version`	`string \| null`Required in parent	—
`dataset.posts[].provenance.schema_version`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 200`
`dataset.posts[].provenance.schema_version`anyOf 2	`null`Required in parent	—
`dataset.sources`	`array`Required in parent	`maxItems: 30`
`dataset.sources[]`	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].accountId`	`string`Required in parent	`format: "uuid"`
`dataset.sources[].platform`	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.sources[].resourceKind`	`string`Required in parent	`enum: ["account","post"]`
`dataset.sources[].providerResourceId`	`string \| null`Required in parent	—
`dataset.sources[].providerResourceId`anyOf 1	`string`Required in parent	`maxLength: 512`
`dataset.sources[].providerResourceId`anyOf 2	`null`Required in parent	—
`dataset.sources[].requestId`	`string \| null`Required in parent	—
`dataset.sources[].requestId`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.sources[].requestId`anyOf 2	`null`Required in parent	—
`dataset.sources[].status`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.sources[].reason`	`string \| null`Required in parent	—
`dataset.sources[].reason`anyOf 1	`string`Required in parent	`maxLength: 8000`
`dataset.sources[].reason`anyOf 2	`null`Required in parent	—
`dataset.sources[].envelope`	`object \| null`Required in parent	—
`dataset.sources[].envelope`anyOf 1	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].envelope.contract_version`anyOf 1	`string`Required in parent	`const: "provider-insights/v1"`
`dataset.sources[].envelope.request_id`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.sources[].envelope.platform`anyOf 1	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.sources[].envelope.resource`anyOf 1	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].envelope.resource.kind`anyOf 1	`string`Required in parent	`enum: ["account","post"]`
`dataset.sources[].envelope.resource.social_account_id`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.sources[].envelope.resource.provider_resource_id`anyOf 1	`string \| null`Required in parent	—
`dataset.sources[].envelope.provider_api_version`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.sources[].envelope.fetched_at`anyOf 1	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.sources[].envelope.status`anyOf 1	`string`Required in parent	`enum: ["available","partial","unavailable"]`
`dataset.sources[].envelope.availability`anyOf 1	`array`Required in parent	`minItems: 1` `maxItems: 64`
`dataset.sources[].envelope.availability[]`anyOf 1	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].envelope.availability[].scope`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 200`
`dataset.sources[].envelope.availability[].status`anyOf 1	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed"]`
`dataset.sources[].envelope.availability[].reason`anyOf 1	`string`Optional / item	`minLength: 1` `maxLength: 2000`
`dataset.sources[].envelope.availability[].diagnostics`anyOf 1	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].envelope.availability[].diagnostics.http_status`anyOf 1	`integer`Required in parent	`minimum: 0` `maximum: 599`
`dataset.sources[].envelope.availability[].diagnostics.failed_step`anyOf 1	`string`Optional / item	`minLength: 1` `maxLength: 200`
`dataset.sources[].envelope.availability[].diagnostics.provider_code`anyOf 1	`number \| string`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_code`anyOf 1 / anyOf 1	`number`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_code`anyOf 1 / anyOf 2	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.provider_subcode`anyOf 1	`number \| string`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_subcode`anyOf 1 / anyOf 1	`number`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_subcode`anyOf 1 / anyOf 2	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.provider_type`anyOf 1	`string`Optional / item	`maxLength: 200`
`dataset.sources[].envelope.availability[].diagnostics.is_transient`anyOf 1	`boolean`Optional / item	—
`dataset.sources[].envelope.availability[].diagnostics.provider_request_id`anyOf 1	`string`Optional / item	`maxLength: 200`
`dataset.sources[].envelope.availability[].diagnostics.access`anyOf 1	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].envelope.availability[].diagnostics.access.login_mode`anyOf 1	`string`Required in parent	`enum: ["instagram_login","facebook_login","threads_user"]`
`dataset.sources[].envelope.availability[].diagnostics.access.provider_host`anyOf 1	`string`Required in parent	`maxLength: 200`
`dataset.sources[].envelope.availability[].diagnostics.access.required_permissions`anyOf 1	`array`Required in parent	`maxItems: 16`
`dataset.sources[].envelope.availability[].diagnostics.access.required_permissions[]`anyOf 1	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.access.current_connection_policy_permissions`anyOf 1	`array`Required in parent	`maxItems: 16`
`dataset.sources[].envelope.availability[].diagnostics.access.current_connection_policy_permissions[]`anyOf 1	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions`anyOf 1	`array \| null`Required in parent	—
`dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions`anyOf 1 / anyOf 1	`array`Required in parent	`maxItems: 128`
`dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions[]`anyOf 1 / anyOf 1	`string`Optional / item	`maxLength: 100`
`dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions`anyOf 1 / anyOf 2	`null`Required in parent	—
`dataset.sources[].envelope.availability[].diagnostics.access.grant_evidence`anyOf 1	`string`Required in parent	`enum: ["exact","unknown"]`
`dataset.sources[].envelope.availability[].diagnostics.access.permission_state`anyOf 1	`string`Required in parent	`enum: ["granted","missing","unknown"]`
`dataset.sources[].envelope.availability[].diagnostics.access.grant_observed_at`anyOf 1	`string`Optional / item	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.sources[].envelope.availability[].diagnostics.access.app_access`anyOf 1	`string`Required in parent	`const: "unverified"`
`dataset.sources[].envelope.availability[].diagnostics.access.next_step`anyOf 1	`string`Required in parent	`maxLength: 1500`
`dataset.sources[].envelope.provider_data`anyOf 1	`any JSON value \| null`Required in parent	—
`dataset.sources[].envelope.provider_data`anyOf 1 / anyOf 1	`any JSON value`Required in parent	—
`dataset.sources[].envelope.provider_data`anyOf 1 / anyOf 2	`null`Required in parent	—
`dataset.sources[].envelope.requested_date_range`anyOf 1	`object \| null`Required in parent	—
`dataset.sources[].envelope.requested_date_range`anyOf 1 / anyOf 1	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].envelope.requested_date_range.start_date`anyOf 1 / anyOf 1	`string`Required in parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`dataset.sources[].envelope.requested_date_range.end_date`anyOf 1 / anyOf 1	`string`Required in parent	`pattern: "^\\d{4}-\\d{2}-\\d{2}$"`
`dataset.sources[].envelope.requested_date_range`anyOf 1 / anyOf 2	`null`Required in parent	—
`dataset.sources[].envelope.cache`anyOf 1	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].envelope.cache.authoritative`anyOf 1	`boolean`Required in parent	`const: false`
`dataset.sources[].envelope.cache.status`anyOf 1	`string`Required in parent	`enum: ["stored","hit","bypassed"]`
`dataset.sources[].envelope.cache.expires_at`anyOf 1	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.sources[].envelope`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics`	`array`Required in parent	`maxItems: 5000`
`dataset.sources[].metrics[]`	`object`Optional / item	`additionalProperties: false`
`dataset.sources[].metrics[].key`	`string`Required in parent	`minLength: 1` `maxLength: 150`
`dataset.sources[].metrics[].definition`	`string`Required in parent	`minLength: 1` `maxLength: 1000`
`dataset.sources[].metrics[].unit`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.sources[].metrics[].grain`	`string`Required in parent	`enum: ["post","account"]`
`dataset.sources[].metrics[].value`	`number \| null`Required in parent	—
`dataset.sources[].metrics[].availability`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.sources[].metrics[].reason`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].reason`anyOf 1	`string`Required in parent	`maxLength: 4000`
`dataset.sources[].metrics[].reason`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].measurement`	`object`Required in parent	`additionalProperties: false`
`dataset.sources[].metrics[].measurement.kind`	`string`Required in parent	`enum: ["lifetime","snapshot","period","unknown"]`
`dataset.sources[].metrics[].measurement.period`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].measurement.period`anyOf 1	`string`Required in parent	`maxLength: 100`
`dataset.sources[].metrics[].measurement.period`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].measurement.start`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].measurement.start`anyOf 1	`string`Required in parent	`maxLength: 100`
`dataset.sources[].metrics[].measurement.start`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].measurement.end`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].measurement.end`anyOf 1	`string`Required in parent	`maxLength: 100`
`dataset.sources[].metrics[].measurement.end`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].measurement.timezone`	`string \| null`Required in parent	—
`dataset.sources[].metrics[].measurement.timezone`anyOf 1	`string`Required in parent	`maxLength: 100`
`dataset.sources[].metrics[].measurement.timezone`anyOf 2	`null`Required in parent	—
`dataset.sources[].metrics[].sourcePath`	`string`Required in parent	`minLength: 1` `maxLength: 2000`
`dataset.coverage`	`object`Required in parent	`additionalProperties: false`
`dataset.coverage.population`	`string`Required in parent	`const: "discovered_posts"`
`dataset.coverage.postsComplete`	`boolean`Required in parent	—
`dataset.coverage.nextCursor`	`string \| null`Required in parent	—
`dataset.coverage.nextCursor`anyOf 1	`string`Required in parent	`maxLength: 16384`
`dataset.coverage.nextCursor`anyOf 2	`null`Required in parent	—
`dataset.coverage.postLimit`	`integer`Required in parent	`minimum: 0` `maximum: 1000`
`dataset.coverage.postInsightsLimit`	`integer`Required in parent	`minimum: 0` `maximum: 20`
`dataset.coverage.omittedPostInsights`	`integer`Required in parent	`minimum: 0` `maximum: 9007199254740991`
`dataset.coverage.notes`	`array`Required in parent	`maxItems: 50`
`dataset.coverage.notes[]`	`string`Optional / item	`maxLength: 2000`
`dataset.customMetrics`	`array`Required in parent	`maxItems: 50`
`dataset.customMetrics[]`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].id`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].name`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].version`	`integer`Required in parent	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`dataset.customMetrics[].expression`	`string`Required in parent	`minLength: 1` `maxLength: 1000`
`dataset.customMetrics[].definition`	`string`Required in parent	`maxLength: 1000`
`dataset.customMetrics[].unit`	`string`Required in parent	`maxLength: 100`
`dataset.customMetrics[].grain`	`string`Required in parent	`enum: ["post","account","compatible_sum"]`
`dataset.customMetrics[].rounding`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].rounding.decimalPlaces`	`integer`Required in parent	`minimum: 0` `maximum: 8`
`dataset.customMetrics[].rounding.mode`	`string`Required in parent	`const: "half_away_from_zero"`
`dataset.customMetrics[].inputs`	`array`Required in parent	`maxItems: 5000`
`dataset.customMetrics[].inputs[]`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].inputs[].requestId`	`string \| null`Required in parent	—
`dataset.customMetrics[].inputs[].requestId`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].inputs[].requestId`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].inputs[].sourcePath`	`string`Required in parent	`maxLength: 2000`
`dataset.customMetrics[].inputs[].value`	`number \| null`Required in parent	—
`dataset.customMetrics[].inputs[].availability`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.customMetrics[].value`	`number \| null`Required in parent	—
`dataset.customMetrics[].availability`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.customMetrics[].reason`	`string \| null`Required in parent	—
`dataset.customMetrics[].reason`anyOf 1	`string`Required in parent	`maxLength: 4000`
`dataset.customMetrics[].reason`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].formula`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].formula.contractVersion`	`string`Required in parent	`const: "analytics-metric/v1"`
`dataset.customMetrics[].formula.id`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].formula.workspaceId`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].formula.name`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].formula.version`	`integer`Required in parent	`minimum: 1` `maximum: 1000000`
`dataset.customMetrics[].formula.expression`	`string`Required in parent	`minLength: 1` `maxLength: 1000`
`dataset.customMetrics[].formula.fields`	`array`Required in parent	`maxItems: 32`
`dataset.customMetrics[].formula.fields[]`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].formula.fields[].identifier`	`string`Required in parent	`pattern: "^[a-z][a-z0-9_]{0,63}$"`
`dataset.customMetrics[].formula.fields[].selector`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].formula.fields[].selector.platform`	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.customMetrics[].formula.fields[].selector.key`	`string`Required in parent	`pattern: "^[A-Za-z][A-Za-z0-9_]{0,100}$"`
`dataset.customMetrics[].formula.fields[].selector.definition`	`string`Required in parent	`minLength: 1` `maxLength: 500`
`dataset.customMetrics[].formula.fields[].selector.unit`	`string`Required in parent	`enum: ["count","seconds","minutes","percent","ratio"]`
`dataset.customMetrics[].formula.fields[].selector.grain`	`string`Required in parent	`enum: ["post","account"]`
`dataset.customMetrics[].formula.fields[].selector.measurementKind`	`string`Required in parent	`enum: ["lifetime","snapshot","period","unknown"]`
`dataset.customMetrics[].formula.fields[].selector.nativePeriod`	`string \| null`Required in parent	—
`dataset.customMetrics[].formula.fields[].selector.nativePeriod`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].formula.fields[].selector.nativePeriod`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].formula.fields[].selector.timezone`	`string \| null`Required in parent	—
`dataset.customMetrics[].formula.fields[].selector.timezone`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].formula.fields[].selector.timezone`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].formula.fields[].aggregation`	`string`Required in parent	`enum: ["single","sum"]`
`dataset.customMetrics[].formula.rounding`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].formula.rounding.decimalPlaces`	`integer`Required in parent	`minimum: 0` `maximum: 8`
`dataset.customMetrics[].formula.rounding.mode`	`string`Required in parent	`const: "half_away_from_zero"`
`dataset.customMetrics[].calculation`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].calculation.contractVersion`	`string`Required in parent	`const: "analytics-metric/v1"`
`dataset.customMetrics[].calculation.workspaceId`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].calculation.datasetId`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].calculation.formulaId`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].calculation.name`	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].calculation.version`	`integer`Required in parent	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`dataset.customMetrics[].calculation.expression`	`string`Required in parent	`maxLength: 1000`
`dataset.customMetrics[].calculation.rounding`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].calculation.rounding.decimalPlaces`	`integer`Required in parent	`minimum: 0` `maximum: 8`
`dataset.customMetrics[].calculation.rounding.mode`	`string`Required in parent	`const: "half_away_from_zero"`
`dataset.customMetrics[].calculation.value`	`number \| null`Required in parent	—
`dataset.customMetrics[].calculation.unit`	`string`Required in parent	`minLength: 1` `maxLength: 200`
`dataset.customMetrics[].calculation.status`	`string`Required in parent	`enum: ["available","not_returned"]`
`dataset.customMetrics[].calculation.code`	`string`Required in parent	`enum: ["ok","invalid_expression","missing_input","incompatible_input","zero_denominator","numeric_limit","workspace_mismatch","ambiguous_input","unknown_exclusion"]`
`dataset.customMetrics[].calculation.reason`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.reason`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 500`
`dataset.customMetrics[].calculation.reason`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.excludedInputIds`	`array`Required in parent	`maxItems: 5000`
`dataset.customMetrics[].calculation.excludedInputIds[]`	`string`Optional / item	`minLength: 1` `maxLength: 1500`
`dataset.customMetrics[].calculation.inputs`	`array`Required in parent	`maxItems: 5000`
`dataset.customMetrics[].calculation.inputs[]`	`object`Optional / item	`additionalProperties: false`
`dataset.customMetrics[].calculation.inputs[].inputId`	`string`Required in parent	`minLength: 1` `maxLength: 1500`
`dataset.customMetrics[].calculation.inputs[].selector`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].calculation.inputs[].selector.platform`	`string`Required in parent	`enum: ["facebook","instagram","threads","youtube"]`
`dataset.customMetrics[].calculation.inputs[].selector.key`	`string`Required in parent	`pattern: "^[A-Za-z][A-Za-z0-9_]{0,100}$"`
`dataset.customMetrics[].calculation.inputs[].selector.definition`	`string`Required in parent	`minLength: 1` `maxLength: 500`
`dataset.customMetrics[].calculation.inputs[].selector.unit`	`string`Required in parent	`enum: ["count","seconds","minutes","percent","ratio"]`
`dataset.customMetrics[].calculation.inputs[].selector.grain`	`string`Required in parent	`enum: ["post","account"]`
`dataset.customMetrics[].calculation.inputs[].selector.measurementKind`	`string`Required in parent	`enum: ["lifetime","snapshot","period","unknown"]`
`dataset.customMetrics[].calculation.inputs[].selector.nativePeriod`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].selector.nativePeriod`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].calculation.inputs[].selector.nativePeriod`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].selector.timezone`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].selector.timezone`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].calculation.inputs[].selector.timezone`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].value`	`number \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].availability`	`string`Required in parent	`enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]`
`dataset.customMetrics[].calculation.inputs[].reason`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].reason`anyOf 1	`string`Required in parent	`maxLength: 8000`
`dataset.customMetrics[].calculation.inputs[].reason`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement`	`object`Required in parent	`additionalProperties: false`
`dataset.customMetrics[].calculation.inputs[].measurement.kind`	`string`Required in parent	`enum: ["lifetime","snapshot","period","unknown"]`
`dataset.customMetrics[].calculation.inputs[].measurement.period`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.period`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].calculation.inputs[].measurement.period`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.start`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.start`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].calculation.inputs[].measurement.start`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.end`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.end`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 64`
`dataset.customMetrics[].calculation.inputs[].measurement.end`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.timezone`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].measurement.timezone`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 100`
`dataset.customMetrics[].calculation.inputs[].measurement.timezone`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].requestId`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].requestId`anyOf 1	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].calculation.inputs[].requestId`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].sourcePath`	`string`Required in parent	`minLength: 1` `maxLength: 1000`
`dataset.customMetrics[].calculation.inputs[].accountId`	`string`Required in parent	`format: "uuid"`
`dataset.customMetrics[].calculation.inputs[].providerResourceId`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].providerResourceId`anyOf 1	`string`Required in parent	`minLength: 1` `maxLength: 512`
`dataset.customMetrics[].calculation.inputs[].providerResourceId`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].fetchedAt`	`string \| null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].fetchedAt`anyOf 1	`string`Required in parent	`format: "date-time"` `pattern: "^(?:(?:\\d\\d[2468][048]\|\\d\\d[13579][26]\|\\d\\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\\d\|30)\|(?:02)-(?:0[1-9]\|1\\d\|2[0-8])))T(?:(?:[01]\\d\|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z\|([+-](?:[01]\\d\|2[0-3]):[0-5]\\d)))$"`
`dataset.customMetrics[].calculation.inputs[].fetchedAt`anyOf 2	`null`Required in parent	—
`dataset.customMetrics[].calculation.inputs[].identifier`	`string`Required in parent	`pattern: "^[a-z][a-z0-9_]{0,63}$"`
`dataset.customMetrics[].calculation.inputs[].included`	`boolean`Required in parent	—
`format`	`string`Required in parent	`enum: ["csv","xlsx","pdf"]`
`locale`	`string`Required in parent	`enum: ["en","zh-Hant"]`
`title`	`string`Optional / item	`maxLength: 160`

Complete JSON Schema

{
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "analytics-render-input/v1"
    },
    "kind": {
      "type": "string",
      "const": "standard"
    },
    "dataset": {
      "type": "object",
      "properties": {
        "contractVersion": {
          "type": "string",
          "const": "analytics-report/v1"
        },
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "reviewedAt": {
          "type": "string",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
          "format": "date-time"
        },
        "selection": {
          "type": "object",
          "properties": {
            "workspaceId": {
              "type": "string",
              "format": "uuid"
            },
            "accountIds": {
              "minItems": 1,
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid"
              }
            },
            "platforms": {
              "minItems": 1,
              "maxItems": 4,
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "facebook",
                  "instagram",
                  "threads",
                  "youtube"
                ]
              }
            },
            "startDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "endDate": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "timezone": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100
            }
          },
          "required": [
            "workspaceId",
            "accountIds",
            "platforms",
            "startDate",
            "endDate",
            "timezone"
          ],
          "additionalProperties": false
        },
        "accounts": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "workspaceId": {
                "type": "string",
                "format": "uuid"
              },
              "platform": {
                "type": "string",
                "enum": [
                  "facebook",
                  "instagram",
                  "threads",
                  "youtube"
                ]
              },
              "name": {
                "type": "string",
                "maxLength": 500
              },
              "connectionStatus": {
                "type": "string",
                "maxLength": 100
              },
              "healthMessage": {
                "type": "string",
                "maxLength": 1000
              }
            },
            "required": [
              "id",
              "workspaceId",
              "platform",
              "name"
            ],
            "additionalProperties": false
          }
        },
        "posts": {
          "maxItems": 1000,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "social_post_id": {
                "type": "string",
                "format": "uuid"
              },
              "workspace_id": {
                "type": "string",
                "format": "uuid"
              },
              "social_account_id": {
                "type": "string",
                "format": "uuid"
              },
              "platform": {
                "type": "string",
                "enum": [
                  "instagram",
                  "facebook",
                  "threads",
                  "youtube"
                ]
              },
              "provider_post_id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 512
              },
              "provider_published_at": {
                "anyOf": [
                  {
                    "type": "string",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                    "format": "date-time"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "content_format": {
                "anyOf": [
                  {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "permalink": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 2048,
                    "format": "uri"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provider_state": {
                "type": "string",
                "enum": [
                  "available",
                  "deleted",
                  "unavailable",
                  "unknown"
                ]
              },
              "first_seen_at": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                "format": "date-time"
              },
              "last_seen_at": {
                "type": "string",
                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                "format": "date-time"
              },
              "scheduled_post_id": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uuid"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provenance": {
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "enum": [
                      "instagram",
                      "facebook",
                      "threads",
                      "youtube"
                    ]
                  },
                  "source": {
                    "type": "string",
                    "enum": [
                      "provider_api",
                      "provider_webhook",
                      "publication_outcome",
                      "backfill"
                    ]
                  },
                  "source_job_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "format": "uuid"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "provider_api_version": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "schema_version": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "provider",
                  "source",
                  "source_job_id",
                  "provider_api_version",
                  "schema_version"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "social_post_id",
              "workspace_id",
              "social_account_id",
              "platform",
              "provider_post_id",
              "provider_published_at",
              "content_format",
              "permalink",
              "provider_state",
              "first_seen_at",
              "last_seen_at",
              "scheduled_post_id",
              "provenance"
            ],
            "additionalProperties": false
          }
        },
        "sources": {
          "maxItems": 30,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "accountId": {
                "type": "string",
                "format": "uuid"
              },
              "platform": {
                "type": "string",
                "enum": [
                  "facebook",
                  "instagram",
                  "threads",
                  "youtube"
                ]
              },
              "resourceKind": {
                "type": "string",
                "enum": [
                  "account",
                  "post"
                ]
              },
              "providerResourceId": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 512
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "requestId": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "uuid"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "available",
                  "partial",
                  "not_returned",
                  "unsupported",
                  "permission_required",
                  "threshold_not_met",
                  "no_data",
                  "failed",
                  "pending",
                  "stale"
                ]
              },
              "reason": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 8000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "envelope": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "contract_version": {
                        "type": "string",
                        "const": "provider-insights/v1"
                      },
                      "request_id": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "platform": {
                        "type": "string",
                        "enum": [
                          "facebook",
                          "instagram",
                          "threads",
                          "youtube"
                        ]
                      },
                      "resource": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "account",
                              "post"
                            ]
                          },
                          "social_account_id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "provider_resource_id": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "kind",
                          "social_account_id",
                          "provider_resource_id"
                        ],
                        "additionalProperties": false
                      },
                      "provider_api_version": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "fetched_at": {
                        "type": "string",
                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                        "format": "date-time"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "available",
                          "partial",
                          "unavailable"
                        ]
                      },
                      "availability": {
                        "minItems": 1,
                        "maxItems": 64,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "scope": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "available",
                                "partial",
                                "not_returned",
                                "unsupported",
                                "permission_required",
                                "threshold_not_met",
                                "no_data",
                                "failed"
                              ]
                            },
                            "reason": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 2000
                            },
                            "diagnostics": {
                              "type": "object",
                              "properties": {
                                "http_status": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 599
                                },
                                "failed_step": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                "provider_code": {
                                  "anyOf": [
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "string",
                                      "maxLength": 100
                                    }
                                  ]
                                },
                                "provider_subcode": {
                                  "anyOf": [
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "string",
                                      "maxLength": 100
                                    }
                                  ]
                                },
                                "provider_type": {
                                  "type": "string",
                                  "maxLength": 200
                                },
                                "is_transient": {
                                  "type": "boolean"
                                },
                                "provider_request_id": {
                                  "type": "string",
                                  "maxLength": 200
                                },
                                "access": {
                                  "type": "object",
                                  "properties": {
                                    "login_mode": {
                                      "type": "string",
                                      "enum": [
                                        "instagram_login",
                                        "facebook_login",
                                        "threads_user"
                                      ]
                                    },
                                    "provider_host": {
                                      "type": "string",
                                      "maxLength": 200
                                    },
                                    "required_permissions": {
                                      "maxItems": 16,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 100
                                      }
                                    },
                                    "current_connection_policy_permissions": {
                                      "maxItems": 16,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 100
                                      }
                                    },
                                    "granted_permissions": {
                                      "anyOf": [
                                        {
                                          "maxItems": 128,
                                          "type": "array",
                                          "items": {
                                            "type": "string",
                                            "maxLength": 100
                                          }
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "grant_evidence": {
                                      "type": "string",
                                      "enum": [
                                        "exact",
                                        "unknown"
                                      ]
                                    },
                                    "permission_state": {
                                      "type": "string",
                                      "enum": [
                                        "granted",
                                        "missing",
                                        "unknown"
                                      ]
                                    },
                                    "grant_observed_at": {
                                      "type": "string",
                                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                      "format": "date-time"
                                    },
                                    "app_access": {
                                      "type": "string",
                                      "const": "unverified"
                                    },
                                    "next_step": {
                                      "type": "string",
                                      "maxLength": 1500
                                    }
                                  },
                                  "required": [
                                    "login_mode",
                                    "provider_host",
                                    "required_permissions",
                                    "current_connection_policy_permissions",
                                    "granted_permissions",
                                    "grant_evidence",
                                    "permission_state",
                                    "app_access",
                                    "next_step"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "required": [
                                "http_status"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "scope",
                            "status"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "provider_data": {
                        "anyOf": [
                          {},
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "requested_date_range": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "start_date": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              },
                              "end_date": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                              }
                            },
                            "required": [
                              "start_date",
                              "end_date"
                            ],
                            "additionalProperties": false
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "cache": {
                        "type": "object",
                        "properties": {
                          "authoritative": {
                            "type": "boolean",
                            "const": false
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "stored",
                              "hit",
                              "bypassed"
                            ]
                          },
                          "expires_at": {
                            "type": "string",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                            "format": "date-time"
                          }
                        },
                        "required": [
                          "authoritative",
                          "status",
                          "expires_at"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "contract_version",
                      "request_id",
                      "platform",
                      "resource",
                      "provider_api_version",
                      "fetched_at",
                      "status",
                      "availability",
                      "provider_data",
                      "requested_date_range",
                      "cache"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "metrics": {
                "maxItems": 5000,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 150
                    },
                    "definition": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1000
                    },
                    "unit": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "grain": {
                      "type": "string",
                      "enum": [
                        "post",
                        "account"
                      ]
                    },
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "availability": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "not_returned",
                        "unsupported",
                        "permission_required",
                        "threshold_not_met",
                        "no_data",
                        "failed",
                        "pending",
                        "stale"
                      ]
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 4000
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "measurement": {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "lifetime",
                            "snapshot",
                            "period",
                            "unknown"
                          ]
                        },
                        "period": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "start": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "end": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "timezone": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "period",
                        "start",
                        "end",
                        "timezone"
                      ],
                      "additionalProperties": false
                    },
                    "sourcePath": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 2000
                    }
                  },
                  "required": [
                    "key",
                    "definition",
                    "unit",
                    "grain",
                    "value",
                    "availability",
                    "reason",
                    "measurement",
                    "sourcePath"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "accountId",
              "platform",
              "resourceKind",
              "providerResourceId",
              "requestId",
              "status",
              "reason",
              "envelope",
              "metrics"
            ],
            "additionalProperties": false
          }
        },
        "coverage": {
          "type": "object",
          "properties": {
            "population": {
              "type": "string",
              "const": "discovered_posts"
            },
            "postsComplete": {
              "type": "boolean"
            },
            "nextCursor": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 16384
                },
                {
                  "type": "null"
                }
              ]
            },
            "postLimit": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1000
            },
            "postInsightsLimit": {
              "type": "integer",
              "minimum": 0,
              "maximum": 20
            },
            "omittedPostInsights": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "notes": {
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 2000
              }
            }
          },
          "required": [
            "population",
            "postsComplete",
            "nextCursor",
            "postLimit",
            "postInsightsLimit",
            "omittedPostInsights",
            "notes"
          ],
          "additionalProperties": false
        },
        "customMetrics": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 100
              },
              "version": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "expression": {
                "type": "string",
                "minLength": 1,
                "maxLength": 1000
              },
              "definition": {
                "type": "string",
                "maxLength": 1000
              },
              "unit": {
                "type": "string",
                "maxLength": 100
              },
              "grain": {
                "type": "string",
                "enum": [
                  "post",
                  "account",
                  "compatible_sum"
                ]
              },
              "rounding": {
                "type": "object",
                "properties": {
                  "decimalPlaces": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 8
                  },
                  "mode": {
                    "type": "string",
                    "const": "half_away_from_zero"
                  }
                },
                "required": [
                  "decimalPlaces",
                  "mode"
                ],
                "additionalProperties": false
              },
              "inputs": {
                "maxItems": 5000,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "requestId": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uuid"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "sourcePath": {
                      "type": "string",
                      "maxLength": 2000
                    },
                    "value": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "availability": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "not_returned",
                        "unsupported",
                        "permission_required",
                        "threshold_not_met",
                        "no_data",
                        "failed",
                        "pending",
                        "stale"
                      ]
                    }
                  },
                  "required": [
                    "requestId",
                    "sourcePath",
                    "value",
                    "availability"
                  ],
                  "additionalProperties": false
                }
              },
              "value": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "availability": {
                "type": "string",
                "enum": [
                  "available",
                  "partial",
                  "not_returned",
                  "unsupported",
                  "permission_required",
                  "threshold_not_met",
                  "no_data",
                  "failed",
                  "pending",
                  "stale"
                ]
              },
              "reason": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 4000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "formula": {
                "type": "object",
                "properties": {
                  "contractVersion": {
                    "type": "string",
                    "const": "analytics-metric/v1"
                  },
                  "id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "version": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000
                  },
                  "expression": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  },
                  "fields": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "identifier": {
                          "type": "string",
                          "pattern": "^[a-z][a-z0-9_]{0,63}$"
                        },
                        "selector": {
                          "type": "object",
                          "properties": {
                            "platform": {
                              "type": "string",
                              "enum": [
                                "facebook",
                                "instagram",
                                "threads",
                                "youtube"
                              ]
                            },
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$"
                            },
                            "definition": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 500
                            },
                            "unit": {
                              "type": "string",
                              "enum": [
                                "count",
                                "seconds",
                                "minutes",
                                "percent",
                                "ratio"
                              ]
                            },
                            "grain": {
                              "type": "string",
                              "enum": [
                                "post",
                                "account"
                              ]
                            },
                            "measurementKind": {
                              "type": "string",
                              "enum": [
                                "lifetime",
                                "snapshot",
                                "period",
                                "unknown"
                              ]
                            },
                            "nativePeriod": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "timezone": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "platform",
                            "key",
                            "definition",
                            "unit",
                            "grain",
                            "measurementKind",
                            "nativePeriod",
                            "timezone"
                          ],
                          "additionalProperties": false
                        },
                        "aggregation": {
                          "type": "string",
                          "enum": [
                            "single",
                            "sum"
                          ]
                        }
                      },
                      "required": [
                        "identifier",
                        "selector",
                        "aggregation"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "rounding": {
                    "type": "object",
                    "properties": {
                      "decimalPlaces": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 8
                      },
                      "mode": {
                        "type": "string",
                        "const": "half_away_from_zero"
                      }
                    },
                    "required": [
                      "decimalPlaces",
                      "mode"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "contractVersion",
                  "id",
                  "workspaceId",
                  "name",
                  "version",
                  "expression",
                  "fields",
                  "rounding"
                ],
                "additionalProperties": false
              },
              "calculation": {
                "type": "object",
                "properties": {
                  "contractVersion": {
                    "type": "string",
                    "const": "analytics-metric/v1"
                  },
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "datasetId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "formulaId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "version": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  "expression": {
                    "type": "string",
                    "maxLength": 1000
                  },
                  "rounding": {
                    "type": "object",
                    "properties": {
                      "decimalPlaces": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 8
                      },
                      "mode": {
                        "type": "string",
                        "const": "half_away_from_zero"
                      }
                    },
                    "required": [
                      "decimalPlaces",
                      "mode"
                    ],
                    "additionalProperties": false
                  },
                  "value": {
                    "type": [
                      "number",
                      "null"
                    ]
                  },
                  "unit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "available",
                      "not_returned"
                    ]
                  },
                  "code": {
                    "type": "string",
                    "enum": [
                      "ok",
                      "invalid_expression",
                      "missing_input",
                      "incompatible_input",
                      "zero_denominator",
                      "numeric_limit",
                      "workspace_mismatch",
                      "ambiguous_input",
                      "unknown_exclusion"
                    ]
                  },
                  "reason": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 500
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "excludedInputIds": {
                    "maxItems": 5000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 1500
                    }
                  },
                  "inputs": {
                    "maxItems": 5000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "inputId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1500
                        },
                        "selector": {
                          "type": "object",
                          "properties": {
                            "platform": {
                              "type": "string",
                              "enum": [
                                "facebook",
                                "instagram",
                                "threads",
                                "youtube"
                              ]
                            },
                            "key": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$"
                            },
                            "definition": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 500
                            },
                            "unit": {
                              "type": "string",
                              "enum": [
                                "count",
                                "seconds",
                                "minutes",
                                "percent",
                                "ratio"
                              ]
                            },
                            "grain": {
                              "type": "string",
                              "enum": [
                                "post",
                                "account"
                              ]
                            },
                            "measurementKind": {
                              "type": "string",
                              "enum": [
                                "lifetime",
                                "snapshot",
                                "period",
                                "unknown"
                              ]
                            },
                            "nativePeriod": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "timezone": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "platform",
                            "key",
                            "definition",
                            "unit",
                            "grain",
                            "measurementKind",
                            "nativePeriod",
                            "timezone"
                          ],
                          "additionalProperties": false
                        },
                        "value": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "availability": {
                          "type": "string",
                          "enum": [
                            "available",
                            "partial",
                            "not_returned",
                            "unsupported",
                            "permission_required",
                            "threshold_not_met",
                            "no_data",
                            "failed",
                            "pending",
                            "stale"
                          ]
                        },
                        "reason": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 8000
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "measurement": {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "enum": [
                                "lifetime",
                                "snapshot",
                                "period",
                                "unknown"
                              ]
                            },
                            "period": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "start": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "end": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "timezone": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "kind",
                            "period",
                            "start",
                            "end",
                            "timezone"
                          ],
                          "additionalProperties": false
                        },
                        "requestId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uuid"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "sourcePath": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 1000
                        },
                        "accountId": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "providerResourceId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 512
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "fetchedAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                              "format": "date-time"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "identifier": {
                          "type": "string",
                          "pattern": "^[a-z][a-z0-9_]{0,63}$"
                        },
                        "included": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "inputId",
                        "selector",
                        "value",
                        "availability",
                        "reason",
                        "measurement",
                        "requestId",
                        "sourcePath",
                        "accountId",
                        "providerResourceId",
                        "fetchedAt",
                        "identifier",
                        "included"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "contractVersion",
                  "workspaceId",
                  "datasetId",
                  "formulaId",
                  "name",
                  "version",
                  "expression",
                  "rounding",
                  "value",
                  "unit",
                  "status",
                  "code",
                  "reason",
                  "excludedInputIds",
                  "inputs"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "id",
              "name",
              "version",
              "expression",
              "definition",
              "unit",
              "grain",
              "rounding",
              "inputs",
              "value",
              "availability",
              "reason"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "contractVersion",
        "id",
        "reviewedAt",
        "selection",
        "accounts",
        "posts",
        "sources",
        "coverage",
        "customMetrics"
      ],
      "additionalProperties": false
    },
    "format": {
      "type": "string",
      "enum": [
        "csv",
        "xlsx",
        "pdf"
      ]
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "zh-Hant"
      ]
    },
    "title": {
      "type": "string",
      "maxLength": 160
    }
  },
  "required": [
    "contract_version",
    "kind",
    "dataset",
    "format",
    "locale"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Example tool call

These examples use fictional values checked against the schemas. Replace the IDs with ones you are authorized to use, the media with ready assets and the dates with your confirmed publishing time. Check the account’s eligibility before submitting a write. This page sends no API requests.

{
  "name": "sosoapi_export_analytics_report",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "dataset": {
      "contractVersion": "analytics-report/v1",
      "id": "11111111-1111-4111-8111-111111111111",
      "reviewedAt": "2099-01-15T09:00:00Z",
      "selection": {
        "workspaceId": "11111111-1111-4111-8111-111111111111",
        "accountIds": [
          "11111111-1111-4111-8111-111111111111"
        ],
        "platforms": [
          "facebook"
        ],
        "startDate": "2099-01-15",
        "endDate": "2099-01-15",
        "timezone": "UTC"
      },
      "accounts": [
        {
          "id": "11111111-1111-4111-8111-111111111111",
          "workspaceId": "11111111-1111-4111-8111-111111111111",
          "platform": "facebook",
          "name": "Fictional report account"
        }
      ],
      "posts": [],
      "sources": [],
      "coverage": {
        "population": "discovered_posts",
        "postsComplete": false,
        "nextCursor": null,
        "postLimit": 0,
        "postInsightsLimit": 0,
        "omittedPostInsights": 0,
        "notes": []
      },
      "customMetrics": []
    },
    "format": "csv"
  }
}

structuredContent

{
  "contract_version": "analytics-render-input/v1",
  "kind": "standard",
  "dataset": {
    "contractVersion": "analytics-report/v1",
    "id": "11111111-1111-4111-8111-111111111111",
    "reviewedAt": "2099-01-15T09:00:00Z",
    "selection": {
      "workspaceId": "11111111-1111-4111-8111-111111111111",
      "accountIds": [
        "11111111-1111-4111-8111-111111111111"
      ],
      "platforms": [
        "facebook"
      ],
      "startDate": "2099-01-15",
      "endDate": "2099-01-15",
      "timezone": "UTC"
    },
    "accounts": [
      {
        "id": "11111111-1111-4111-8111-111111111111",
        "workspaceId": "11111111-1111-4111-8111-111111111111",
        "platform": "facebook",
        "name": "Fictional report account"
      }
    ],
    "posts": [],
    "sources": [],
    "coverage": {
      "population": "discovered_posts",
      "postsComplete": false,
      "nextCursor": null,
      "postLimit": 0,
      "postInsightsLimit": 0,
      "omittedPostInsights": 0,
      "notes": []
    },
    "customMetrics": []
  },
  "format": "csv",
  "locale": "en"
}

/analytics-api/reporting/export

Install or connect MCP