A busca carrega apenas quando você a usa. Explore todas as categorias abaixo.

Ferramenta MCP

Pré-visualizar uma métrica personalizada

sosoapi_preview_custom_metric

Pré-visualizar uma métrica personalizada. Usa o conjunto de dados e a versão explicitamente definidos e revisados; a fonte não é atualizada automaticamente. As entradas de renderização podem ser encaminhadas por um pipe para sosoapi report render --output FILE.

Ler como Markdown

Perfis e transportes

Perfis: full · Transportes: stdio, http

Escolha core ou full para controlar quais ferramentas seu cliente vê; isso não altera suas permissões. O envio de arquivos locais exige stdio e não está disponível por HTTP. Defina SOSOAPI_OUTPUT_SCHEMAS=1 para incluir schemas de saída na descoberta. As ferramentas retornam resultados estruturados com ou sem essa configuração.

Permissões e efeitos colaterais

As anotações ajudam os clientes a descrever uma ferramenta. Cada chamada ainda verifica autenticação, função, acesso a recursos e concessões de capacidades do usuário.

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

Campos de entrada

Obrigatório significa obrigatório dentro do objeto pai e da ramificação selecionada. Um filho obrigatório não torna obrigatório um pai opcional. As regras e nomes de campos abaixo são copiados do contrato.

Campos de entrada
Campo / ramificaçãoTipo / obrigatórioRestrições
$objectObrigatório no objeto pai
  • additionalProperties: false
workspace_idstringObrigatório no objeto pai
  • format: "uuid"
formulaobjectObrigatório no objeto pai
  • additionalProperties: false
formula.contractVersionstringObrigatório no objeto pai
  • enum: ["analytics-metric/v1"]
formula.idstringObrigatório no objeto pai
  • format: "uuid"
formula.workspaceIdstringObrigatório no objeto pai
  • format: "uuid"
formula.namestringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
formula.versionintegerObrigatório no objeto pai
  • minimum: 1
  • maximum: 1000000
formula.expressionstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 1000
formula.fieldsarrayObrigatório no objeto pai
  • maxItems: 32
formula.fields[]objectOpcional / item
  • additionalProperties: false
formula.fields[].identifierstringObrigatório no objeto pai
  • pattern: "^[a-z][a-z0-9_]{0,63}$"
formula.fields[].selectorobjectObrigatório no objeto pai
  • additionalProperties: false
formula.fields[].selector.platformstringObrigatório no objeto pai
  • enum: ["facebook","instagram","threads","youtube"]
formula.fields[].selector.keystringObrigatório no objeto pai
  • pattern: "^[A-Za-z][A-Za-z0-9_]{0,100}$"
formula.fields[].selector.definitionstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 500
formula.fields[].selector.unitstringObrigatório no objeto pai
  • enum: ["count","seconds","minutes","percent","ratio"]
formula.fields[].selector.grainstringObrigatório no objeto pai
  • enum: ["post","account"]
formula.fields[].selector.measurementKindstringObrigatório no objeto pai
  • enum: ["lifetime","snapshot","period","unknown"]
formula.fields[].selector.nativePeriodstring | nullObrigatório no objeto pai—
formula.fields[].selector.nativePeriodanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
formula.fields[].selector.nativePeriodanyOf 2nullObrigatório no objeto pai—
formula.fields[].selector.timezonestring | nullObrigatório no objeto pai—
formula.fields[].selector.timezoneanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
formula.fields[].selector.timezoneanyOf 2nullObrigatório no objeto pai—
formula.fields[].aggregationstringObrigatório no objeto pai
  • enum: ["single","sum"]
formula.roundingobjectObrigatório no objeto pai
  • additionalProperties: false
formula.rounding.decimalPlacesintegerObrigatório no objeto pai
  • minimum: 0
  • maximum: 8
formula.rounding.modestringObrigatório no objeto pai
  • enum: ["half_away_from_zero"]
datasetobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.contractVersionstringObrigatório no objeto pai
  • enum: ["analytics-report/v1"]
dataset.idstringObrigatório no objeto pai
  • format: "uuid"
dataset.reviewedAtstringObrigatório no objeto pai
  • 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.selectionobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.selection.workspaceIdstringObrigatório no objeto pai
  • format: "uuid"
dataset.selection.accountIdsarrayObrigatório no objeto pai
  • minItems: 1
  • maxItems: 50
dataset.selection.accountIds[]stringOpcional / item
  • format: "uuid"
dataset.selection.platformsarrayObrigatório no objeto pai
  • minItems: 1
  • maxItems: 4
dataset.selection.platforms[]stringOpcional / item
  • enum: ["facebook","instagram","threads","youtube"]
dataset.selection.startDatestringObrigatório no objeto pai
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
dataset.selection.endDatestringObrigatório no objeto pai
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
dataset.selection.timezonestringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.accountsarrayObrigatório no objeto pai
  • maxItems: 50
dataset.accounts[]objectOpcional / item
  • additionalProperties: false
dataset.accounts[].idstringObrigatório no objeto pai
  • format: "uuid"
dataset.accounts[].workspaceIdstringObrigatório no objeto pai
  • format: "uuid"
dataset.accounts[].platformstringObrigatório no objeto pai
  • enum: ["facebook","instagram","threads","youtube"]
dataset.accounts[].namestringObrigatório no objeto pai
  • maxLength: 500
dataset.accounts[].connectionStatusstringOpcional / item
  • maxLength: 100
dataset.accounts[].healthMessagestringOpcional / item
  • maxLength: 1000
dataset.postsarrayObrigatório no objeto pai
  • maxItems: 1000
dataset.posts[]objectOpcional / item
  • additionalProperties: false
dataset.posts[].social_post_idstringObrigatório no objeto pai
  • format: "uuid"
dataset.posts[].workspace_idstringObrigatório no objeto pai
  • format: "uuid"
dataset.posts[].social_account_idstringObrigatório no objeto pai
  • format: "uuid"
dataset.posts[].platformstringObrigatório no objeto pai
  • enum: ["instagram","facebook","threads","youtube"]
dataset.posts[].provider_post_idstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 512
dataset.posts[].provider_published_atstring | nullObrigatório no objeto pai—
dataset.posts[].provider_published_atanyOf 1stringObrigatório no objeto pai
  • 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_atanyOf 2nullObrigatório no objeto pai—
dataset.posts[].content_formatstring | nullObrigatório no objeto pai—
dataset.posts[].content_formatanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.posts[].content_formatanyOf 2nullObrigatório no objeto pai—
dataset.posts[].permalinkstring | nullObrigatório no objeto pai—
dataset.posts[].permalinkanyOf 1stringObrigatório no objeto pai
  • format: "uri"
  • maxLength: 2048
dataset.posts[].permalinkanyOf 2nullObrigatório no objeto pai—
dataset.posts[].provider_statestringObrigatório no objeto pai
  • enum: ["available","deleted","unavailable","unknown"]
dataset.posts[].first_seen_atstringObrigatório no objeto pai
  • 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_atstringObrigatório no objeto pai
  • 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_idstring | nullObrigatório no objeto pai—
dataset.posts[].scheduled_post_idanyOf 1stringObrigatório no objeto pai
  • format: "uuid"
dataset.posts[].scheduled_post_idanyOf 2nullObrigatório no objeto pai—
dataset.posts[].provenanceobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.posts[].provenance.providerstringObrigatório no objeto pai
  • enum: ["instagram","facebook","threads","youtube"]
dataset.posts[].provenance.sourcestringObrigatório no objeto pai
  • enum: ["provider_api","provider_webhook","publication_outcome","backfill"]
dataset.posts[].provenance.source_job_idstring | nullObrigatório no objeto pai—
dataset.posts[].provenance.source_job_idanyOf 1stringObrigatório no objeto pai
  • format: "uuid"
dataset.posts[].provenance.source_job_idanyOf 2nullObrigatório no objeto pai—
dataset.posts[].provenance.provider_api_versionstring | nullObrigatório no objeto pai—
dataset.posts[].provenance.provider_api_versionanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 200
dataset.posts[].provenance.provider_api_versionanyOf 2nullObrigatório no objeto pai—
dataset.posts[].provenance.schema_versionstring | nullObrigatório no objeto pai—
dataset.posts[].provenance.schema_versionanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 200
dataset.posts[].provenance.schema_versionanyOf 2nullObrigatório no objeto pai—
dataset.sourcesarrayObrigatório no objeto pai
  • maxItems: 30
dataset.sources[]objectOpcional / item
  • additionalProperties: false
dataset.sources[].accountIdstringObrigatório no objeto pai
  • format: "uuid"
dataset.sources[].platformstringObrigatório no objeto pai
  • enum: ["facebook","instagram","threads","youtube"]
dataset.sources[].resourceKindstringObrigatório no objeto pai
  • enum: ["account","post"]
dataset.sources[].providerResourceIdstring | nullObrigatório no objeto pai—
dataset.sources[].providerResourceIdanyOf 1stringObrigatório no objeto pai
  • maxLength: 512
dataset.sources[].providerResourceIdanyOf 2nullObrigatório no objeto pai—
dataset.sources[].requestIdstring | nullObrigatório no objeto pai—
dataset.sources[].requestIdanyOf 1stringObrigatório no objeto pai
  • format: "uuid"
dataset.sources[].requestIdanyOf 2nullObrigatório no objeto pai—
dataset.sources[].statusstringObrigatório no objeto pai
  • enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]
dataset.sources[].reasonstring | nullObrigatório no objeto pai—
dataset.sources[].reasonanyOf 1stringObrigatório no objeto pai
  • maxLength: 8000
dataset.sources[].reasonanyOf 2nullObrigatório no objeto pai—
dataset.sources[].envelopeobject | nullObrigatório no objeto pai—
dataset.sources[].envelopeanyOf 1objectObrigatório no objeto pai
  • additionalProperties: false
dataset.sources[].envelope.contract_versionanyOf 1stringObrigatório no objeto pai
  • enum: ["provider-insights/v1"]
dataset.sources[].envelope.request_idanyOf 1stringObrigatório no objeto pai
  • format: "uuid"
dataset.sources[].envelope.platformanyOf 1stringObrigatório no objeto pai
  • enum: ["facebook","instagram","threads","youtube"]
dataset.sources[].envelope.resourceanyOf 1objectObrigatório no objeto pai
  • additionalProperties: false
dataset.sources[].envelope.resource.kindanyOf 1stringObrigatório no objeto pai
  • enum: ["account","post"]
dataset.sources[].envelope.resource.social_account_idanyOf 1stringObrigatório no objeto pai
  • format: "uuid"
dataset.sources[].envelope.resource.provider_resource_idanyOf 1string | nullObrigatório no objeto pai—
dataset.sources[].envelope.provider_api_versionanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.sources[].envelope.fetched_atanyOf 1stringObrigatório no objeto pai
  • 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.statusanyOf 1stringObrigatório no objeto pai
  • enum: ["available","partial","unavailable"]
dataset.sources[].envelope.availabilityanyOf 1arrayObrigatório no objeto pai
  • minItems: 1
  • maxItems: 64
dataset.sources[].envelope.availability[]anyOf 1objectOpcional / item
  • additionalProperties: false
dataset.sources[].envelope.availability[].scopeanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 200
dataset.sources[].envelope.availability[].statusanyOf 1stringObrigatório no objeto pai
  • enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed"]
dataset.sources[].envelope.availability[].reasonanyOf 1stringOpcional / item
  • minLength: 1
  • maxLength: 2000
dataset.sources[].envelope.availability[].diagnosticsanyOf 1objectOpcional / item
  • additionalProperties: false
dataset.sources[].envelope.availability[].diagnostics.http_statusanyOf 1integerObrigatório no objeto pai
  • minimum: 0
  • maximum: 599
dataset.sources[].envelope.availability[].diagnostics.failed_stepanyOf 1stringOpcional / item
  • minLength: 1
  • maxLength: 200
dataset.sources[].envelope.availability[].diagnostics.provider_codeanyOf 1number | stringOpcional / item—
dataset.sources[].envelope.availability[].diagnostics.provider_codeanyOf 1 / anyOf 1numberOpcional / item—
dataset.sources[].envelope.availability[].diagnostics.provider_codeanyOf 1 / anyOf 2stringOpcional / item
  • maxLength: 100
dataset.sources[].envelope.availability[].diagnostics.provider_subcodeanyOf 1number | stringOpcional / item—
dataset.sources[].envelope.availability[].diagnostics.provider_subcodeanyOf 1 / anyOf 1numberOpcional / item—
dataset.sources[].envelope.availability[].diagnostics.provider_subcodeanyOf 1 / anyOf 2stringOpcional / item
  • maxLength: 100
dataset.sources[].envelope.availability[].diagnostics.provider_typeanyOf 1stringOpcional / item
  • maxLength: 200
dataset.sources[].envelope.availability[].diagnostics.is_transientanyOf 1booleanOpcional / item—
dataset.sources[].envelope.availability[].diagnostics.provider_request_idanyOf 1stringOpcional / item
  • maxLength: 200
dataset.sources[].envelope.availability[].diagnostics.accessanyOf 1objectOpcional / item
  • additionalProperties: false
dataset.sources[].envelope.availability[].diagnostics.access.login_modeanyOf 1stringObrigatório no objeto pai
  • enum: ["instagram_login","facebook_login","threads_user"]
dataset.sources[].envelope.availability[].diagnostics.access.provider_hostanyOf 1stringObrigatório no objeto pai
  • maxLength: 200
dataset.sources[].envelope.availability[].diagnostics.access.required_permissionsanyOf 1arrayObrigatório no objeto pai
  • maxItems: 16
dataset.sources[].envelope.availability[].diagnostics.access.required_permissions[]anyOf 1stringOpcional / item
  • maxLength: 100
dataset.sources[].envelope.availability[].diagnostics.access.current_connection_policy_permissionsanyOf 1arrayObrigatório no objeto pai
  • maxItems: 16
dataset.sources[].envelope.availability[].diagnostics.access.current_connection_policy_permissions[]anyOf 1stringOpcional / item
  • maxLength: 100
dataset.sources[].envelope.availability[].diagnostics.access.granted_permissionsanyOf 1array | nullObrigatório no objeto pai—
dataset.sources[].envelope.availability[].diagnostics.access.granted_permissionsanyOf 1 / anyOf 1arrayObrigatório no objeto pai
  • maxItems: 128
dataset.sources[].envelope.availability[].diagnostics.access.granted_permissions[]anyOf 1 / anyOf 1stringOpcional / item
  • maxLength: 100
dataset.sources[].envelope.availability[].diagnostics.access.granted_permissionsanyOf 1 / anyOf 2nullObrigatório no objeto pai—
dataset.sources[].envelope.availability[].diagnostics.access.grant_evidenceanyOf 1stringObrigatório no objeto pai
  • enum: ["exact","unknown"]
dataset.sources[].envelope.availability[].diagnostics.access.permission_stateanyOf 1stringObrigatório no objeto pai
  • enum: ["granted","missing","unknown"]
dataset.sources[].envelope.availability[].diagnostics.access.grant_observed_atanyOf 1stringOpcional / 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_accessanyOf 1stringObrigatório no objeto pai
  • enum: ["unverified"]
dataset.sources[].envelope.availability[].diagnostics.access.next_stepanyOf 1stringObrigatório no objeto pai
  • maxLength: 1500
dataset.sources[].envelope.provider_dataanyOf 1any JSON value | nullObrigatório no objeto pai—
dataset.sources[].envelope.provider_dataanyOf 1 / anyOf 1any JSON valueObrigatório no objeto pai—
dataset.sources[].envelope.provider_dataanyOf 1 / anyOf 2nullObrigatório no objeto pai—
dataset.sources[].envelope.requested_date_rangeanyOf 1object | nullObrigatório no objeto pai—
dataset.sources[].envelope.requested_date_rangeanyOf 1 / anyOf 1objectObrigatório no objeto pai
  • additionalProperties: false
dataset.sources[].envelope.requested_date_range.start_dateanyOf 1 / anyOf 1stringObrigatório no objeto pai
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
dataset.sources[].envelope.requested_date_range.end_dateanyOf 1 / anyOf 1stringObrigatório no objeto pai
  • pattern: "^\\d{4}-\\d{2}-\\d{2}$"
dataset.sources[].envelope.requested_date_rangeanyOf 1 / anyOf 2nullObrigatório no objeto pai—
dataset.sources[].envelope.cacheanyOf 1objectObrigatório no objeto pai
  • additionalProperties: false
dataset.sources[].envelope.cache.authoritativeanyOf 1booleanObrigatório no objeto pai
  • enum: [false]
dataset.sources[].envelope.cache.statusanyOf 1stringObrigatório no objeto pai
  • enum: ["stored","hit","bypassed"]
dataset.sources[].envelope.cache.expires_atanyOf 1stringObrigatório no objeto pai
  • 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[].envelopeanyOf 2nullObrigatório no objeto pai—
dataset.sources[].metricsarrayObrigatório no objeto pai
  • maxItems: 5000
dataset.sources[].metrics[]objectOpcional / item
  • additionalProperties: false
dataset.sources[].metrics[].keystringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 150
dataset.sources[].metrics[].definitionstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 1000
dataset.sources[].metrics[].unitstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.sources[].metrics[].grainstringObrigatório no objeto pai
  • enum: ["post","account"]
dataset.sources[].metrics[].valuenumber | nullObrigatório no objeto pai—
dataset.sources[].metrics[].availabilitystringObrigatório no objeto pai
  • enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]
dataset.sources[].metrics[].reasonstring | nullObrigatório no objeto pai—
dataset.sources[].metrics[].reasonanyOf 1stringObrigatório no objeto pai
  • maxLength: 4000
dataset.sources[].metrics[].reasonanyOf 2nullObrigatório no objeto pai—
dataset.sources[].metrics[].measurementobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.sources[].metrics[].measurement.kindstringObrigatório no objeto pai
  • enum: ["lifetime","snapshot","period","unknown"]
dataset.sources[].metrics[].measurement.periodstring | nullObrigatório no objeto pai—
dataset.sources[].metrics[].measurement.periodanyOf 1stringObrigatório no objeto pai
  • maxLength: 100
dataset.sources[].metrics[].measurement.periodanyOf 2nullObrigatório no objeto pai—
dataset.sources[].metrics[].measurement.startstring | nullObrigatório no objeto pai—
dataset.sources[].metrics[].measurement.startanyOf 1stringObrigatório no objeto pai
  • maxLength: 100
dataset.sources[].metrics[].measurement.startanyOf 2nullObrigatório no objeto pai—
dataset.sources[].metrics[].measurement.endstring | nullObrigatório no objeto pai—
dataset.sources[].metrics[].measurement.endanyOf 1stringObrigatório no objeto pai
  • maxLength: 100
dataset.sources[].metrics[].measurement.endanyOf 2nullObrigatório no objeto pai—
dataset.sources[].metrics[].measurement.timezonestring | nullObrigatório no objeto pai—
dataset.sources[].metrics[].measurement.timezoneanyOf 1stringObrigatório no objeto pai
  • maxLength: 100
dataset.sources[].metrics[].measurement.timezoneanyOf 2nullObrigatório no objeto pai—
dataset.sources[].metrics[].sourcePathstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 2000
dataset.coverageobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.coverage.populationstringObrigatório no objeto pai
  • enum: ["discovered_posts"]
dataset.coverage.postsCompletebooleanObrigatório no objeto pai—
dataset.coverage.nextCursorstring | nullObrigatório no objeto pai—
dataset.coverage.nextCursoranyOf 1stringObrigatório no objeto pai
  • maxLength: 16384
dataset.coverage.nextCursoranyOf 2nullObrigatório no objeto pai—
dataset.coverage.postLimitintegerObrigatório no objeto pai
  • minimum: 0
  • maximum: 1000
dataset.coverage.postInsightsLimitintegerObrigatório no objeto pai
  • minimum: 0
  • maximum: 20
dataset.coverage.omittedPostInsightsintegerObrigatório no objeto pai
  • minimum: 0
  • maximum: 9007199254740991
dataset.coverage.notesarrayObrigatório no objeto pai
  • maxItems: 50
dataset.coverage.notes[]stringOpcional / item
  • maxLength: 2000
dataset.customMetricsarrayObrigatório no objeto pai
  • maxItems: 50
dataset.customMetrics[]objectOpcional / item
  • additionalProperties: false
dataset.customMetrics[].idstringObrigatório no objeto pai
  • format: "uuid"
dataset.customMetrics[].namestringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.customMetrics[].versionintegerObrigatório no objeto pai
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
dataset.customMetrics[].expressionstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 1000
dataset.customMetrics[].definitionstringObrigatório no objeto pai
  • maxLength: 1000
dataset.customMetrics[].unitstringObrigatório no objeto pai
  • maxLength: 100
dataset.customMetrics[].grainstringObrigatório no objeto pai
  • enum: ["post","account","compatible_sum"]
dataset.customMetrics[].roundingobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.customMetrics[].rounding.decimalPlacesintegerObrigatório no objeto pai
  • minimum: 0
  • maximum: 8
dataset.customMetrics[].rounding.modestringObrigatório no objeto pai
  • enum: ["half_away_from_zero"]
dataset.customMetrics[].inputsarrayObrigatório no objeto pai
  • maxItems: 5000
dataset.customMetrics[].inputs[]objectOpcional / item
  • additionalProperties: false
dataset.customMetrics[].inputs[].requestIdstring | nullObrigatório no objeto pai—
dataset.customMetrics[].inputs[].requestIdanyOf 1stringObrigatório no objeto pai
  • format: "uuid"
dataset.customMetrics[].inputs[].requestIdanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].inputs[].sourcePathstringObrigatório no objeto pai
  • maxLength: 2000
dataset.customMetrics[].inputs[].valuenumber | nullObrigatório no objeto pai—
dataset.customMetrics[].inputs[].availabilitystringObrigatório no objeto pai
  • enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]
dataset.customMetrics[].valuenumber | nullObrigatório no objeto pai—
dataset.customMetrics[].availabilitystringObrigatório no objeto pai
  • enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]
dataset.customMetrics[].reasonstring | nullObrigatório no objeto pai—
dataset.customMetrics[].reasonanyOf 1stringObrigatório no objeto pai
  • maxLength: 4000
dataset.customMetrics[].reasonanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].formulaobjectOpcional / item
  • additionalProperties: false
dataset.customMetrics[].formula.contractVersionstringObrigatório no objeto pai
  • enum: ["analytics-metric/v1"]
dataset.customMetrics[].formula.idstringObrigatório no objeto pai
  • format: "uuid"
dataset.customMetrics[].formula.workspaceIdstringObrigatório no objeto pai
  • format: "uuid"
dataset.customMetrics[].formula.namestringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.customMetrics[].formula.versionintegerObrigatório no objeto pai
  • minimum: 1
  • maximum: 1000000
dataset.customMetrics[].formula.expressionstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 1000
dataset.customMetrics[].formula.fieldsarrayObrigatório no objeto pai
  • maxItems: 32
dataset.customMetrics[].formula.fields[]objectOpcional / item
  • additionalProperties: false
dataset.customMetrics[].formula.fields[].identifierstringObrigatório no objeto pai
  • pattern: "^[a-z][a-z0-9_]{0,63}$"
dataset.customMetrics[].formula.fields[].selectorobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.customMetrics[].formula.fields[].selector.platformstringObrigatório no objeto pai
  • enum: ["facebook","instagram","threads","youtube"]
dataset.customMetrics[].formula.fields[].selector.keystringObrigatório no objeto pai
  • pattern: "^[A-Za-z][A-Za-z0-9_]{0,100}$"
dataset.customMetrics[].formula.fields[].selector.definitionstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 500
dataset.customMetrics[].formula.fields[].selector.unitstringObrigatório no objeto pai
  • enum: ["count","seconds","minutes","percent","ratio"]
dataset.customMetrics[].formula.fields[].selector.grainstringObrigatório no objeto pai
  • enum: ["post","account"]
dataset.customMetrics[].formula.fields[].selector.measurementKindstringObrigatório no objeto pai
  • enum: ["lifetime","snapshot","period","unknown"]
dataset.customMetrics[].formula.fields[].selector.nativePeriodstring | nullObrigatório no objeto pai—
dataset.customMetrics[].formula.fields[].selector.nativePeriodanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
dataset.customMetrics[].formula.fields[].selector.nativePeriodanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].formula.fields[].selector.timezonestring | nullObrigatório no objeto pai—
dataset.customMetrics[].formula.fields[].selector.timezoneanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.customMetrics[].formula.fields[].selector.timezoneanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].formula.fields[].aggregationstringObrigatório no objeto pai
  • enum: ["single","sum"]
dataset.customMetrics[].formula.roundingobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.customMetrics[].formula.rounding.decimalPlacesintegerObrigatório no objeto pai
  • minimum: 0
  • maximum: 8
dataset.customMetrics[].formula.rounding.modestringObrigatório no objeto pai
  • enum: ["half_away_from_zero"]
dataset.customMetrics[].calculationobjectOpcional / item
  • additionalProperties: false
dataset.customMetrics[].calculation.contractVersionstringObrigatório no objeto pai
  • enum: ["analytics-metric/v1"]
dataset.customMetrics[].calculation.workspaceIdstringObrigatório no objeto pai
  • format: "uuid"
dataset.customMetrics[].calculation.datasetIdstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.customMetrics[].calculation.formulaIdstringObrigatório no objeto pai
  • format: "uuid"
dataset.customMetrics[].calculation.namestringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.customMetrics[].calculation.versionintegerObrigatório no objeto pai
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
dataset.customMetrics[].calculation.expressionstringObrigatório no objeto pai
  • maxLength: 1000
dataset.customMetrics[].calculation.roundingobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.customMetrics[].calculation.rounding.decimalPlacesintegerObrigatório no objeto pai
  • minimum: 0
  • maximum: 8
dataset.customMetrics[].calculation.rounding.modestringObrigatório no objeto pai
  • enum: ["half_away_from_zero"]
dataset.customMetrics[].calculation.valuenumber | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.unitstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 200
dataset.customMetrics[].calculation.statusstringObrigatório no objeto pai
  • enum: ["available","not_returned"]
dataset.customMetrics[].calculation.codestringObrigatório no objeto pai
  • enum: ["ok","invalid_expression","missing_input","incompatible_input","zero_denominator","numeric_limit","workspace_mismatch","ambiguous_input","unknown_exclusion"]
dataset.customMetrics[].calculation.reasonstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.reasonanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 500
dataset.customMetrics[].calculation.reasonanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.excludedInputIdsarrayObrigatório no objeto pai
  • maxItems: 5000
dataset.customMetrics[].calculation.excludedInputIds[]stringOpcional / item
  • minLength: 1
  • maxLength: 1500
dataset.customMetrics[].calculation.inputsarrayObrigatório no objeto pai
  • maxItems: 5000
dataset.customMetrics[].calculation.inputs[]objectOpcional / item
  • additionalProperties: false
dataset.customMetrics[].calculation.inputs[].inputIdstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 1500
dataset.customMetrics[].calculation.inputs[].selectorobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.customMetrics[].calculation.inputs[].selector.platformstringObrigatório no objeto pai
  • enum: ["facebook","instagram","threads","youtube"]
dataset.customMetrics[].calculation.inputs[].selector.keystringObrigatório no objeto pai
  • pattern: "^[A-Za-z][A-Za-z0-9_]{0,100}$"
dataset.customMetrics[].calculation.inputs[].selector.definitionstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 500
dataset.customMetrics[].calculation.inputs[].selector.unitstringObrigatório no objeto pai
  • enum: ["count","seconds","minutes","percent","ratio"]
dataset.customMetrics[].calculation.inputs[].selector.grainstringObrigatório no objeto pai
  • enum: ["post","account"]
dataset.customMetrics[].calculation.inputs[].selector.measurementKindstringObrigatório no objeto pai
  • enum: ["lifetime","snapshot","period","unknown"]
dataset.customMetrics[].calculation.inputs[].selector.nativePeriodstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].selector.nativePeriodanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
dataset.customMetrics[].calculation.inputs[].selector.nativePeriodanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].selector.timezonestring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].selector.timezoneanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.customMetrics[].calculation.inputs[].selector.timezoneanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].valuenumber | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].availabilitystringObrigatório no objeto pai
  • enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]
dataset.customMetrics[].calculation.inputs[].reasonstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].reasonanyOf 1stringObrigatório no objeto pai
  • maxLength: 8000
dataset.customMetrics[].calculation.inputs[].reasonanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].measurementobjectObrigatório no objeto pai
  • additionalProperties: false
dataset.customMetrics[].calculation.inputs[].measurement.kindstringObrigatório no objeto pai
  • enum: ["lifetime","snapshot","period","unknown"]
dataset.customMetrics[].calculation.inputs[].measurement.periodstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].measurement.periodanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
dataset.customMetrics[].calculation.inputs[].measurement.periodanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].measurement.startstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].measurement.startanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
dataset.customMetrics[].calculation.inputs[].measurement.startanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].measurement.endstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].measurement.endanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
dataset.customMetrics[].calculation.inputs[].measurement.endanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].measurement.timezonestring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].measurement.timezoneanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
dataset.customMetrics[].calculation.inputs[].measurement.timezoneanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].requestIdstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].requestIdanyOf 1stringObrigatório no objeto pai
  • format: "uuid"
dataset.customMetrics[].calculation.inputs[].requestIdanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].sourcePathstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 1000
dataset.customMetrics[].calculation.inputs[].accountIdstringObrigatório no objeto pai
  • format: "uuid"
dataset.customMetrics[].calculation.inputs[].providerResourceIdstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].providerResourceIdanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 512
dataset.customMetrics[].calculation.inputs[].providerResourceIdanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].fetchedAtstring | nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].fetchedAtanyOf 1stringObrigatório no objeto pai
  • 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[].fetchedAtanyOf 2nullObrigatório no objeto pai—
dataset.customMetrics[].calculation.inputs[].identifierstringObrigatório no objeto pai
  • pattern: "^[a-z][a-z0-9_]{0,63}$"
dataset.customMetrics[].calculation.inputs[].includedbooleanObrigatório no objeto pai—
excluded_input_idsarrayOpcional / item
  • maxItems: 5000
excluded_input_ids[]stringOpcional / item
  • maxLength: 4000
JSON Schema completo
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "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
    },
    "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
    },
    "excluded_input_ids": {
      "maxItems": 5000,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 4000
      }
    }
  },
  "required": [
    "workspace_id",
    "formula",
    "dataset"
  ],
  "additionalProperties": false
}

Saída estruturada

Este schema descreve structuredContent em um resultado de ferramenta bem-sucedido. A resposta MCP também inclui content e pode definir isError quando uma chamada falha. Para publicações, consulte o resultado final do post em vez de tratar uma requisição aceita ou resposta de texto como confirmação. A operação de API vinculada explica as permissões e regras de repetição.

Obrigatório significa obrigatório dentro do objeto pai e da ramificação selecionada. Um filho obrigatório não torna obrigatório um pai opcional. As regras e nomes de campos abaixo são copiados do contrato.

Saída estruturada
Campo / ramificaçãoTipo / obrigatórioRestrições
$objectObrigatório no objeto pai
  • additionalProperties: false
contractVersionstringObrigatório no objeto pai
  • const: "analytics-metric/v1"
workspaceIdstringObrigatório no objeto pai
  • format: "uuid"
datasetIdstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
formulaIdstringObrigatório no objeto pai
  • format: "uuid"
namestringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
versionintegerObrigatório no objeto pai
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
expressionstringObrigatório no objeto pai
  • maxLength: 1000
roundingobjectObrigatório no objeto pai
  • additionalProperties: false
rounding.decimalPlacesintegerObrigatório no objeto pai
  • minimum: 0
  • maximum: 8
rounding.modestringObrigatório no objeto pai
  • const: "half_away_from_zero"
valuenumber | nullObrigatório no objeto pai—
unitstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 200
statusstringObrigatório no objeto pai
  • enum: ["available","not_returned"]
codestringObrigatório no objeto pai
  • enum: ["ok","invalid_expression","missing_input","incompatible_input","zero_denominator","numeric_limit","workspace_mismatch","ambiguous_input","unknown_exclusion"]
reasonstring | nullObrigatório no objeto pai—
reasonanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 500
reasonanyOf 2nullObrigatório no objeto pai—
excludedInputIdsarrayObrigatório no objeto pai
  • maxItems: 5000
excludedInputIds[]stringOpcional / item
  • minLength: 1
  • maxLength: 1500
inputsarrayObrigatório no objeto pai
  • maxItems: 5000
inputs[]objectOpcional / item
  • additionalProperties: false
inputs[].inputIdstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 1500
inputs[].selectorobjectObrigatório no objeto pai
  • additionalProperties: false
inputs[].selector.platformstringObrigatório no objeto pai
  • enum: ["facebook","instagram","threads","youtube"]
inputs[].selector.keystringObrigatório no objeto pai
  • pattern: "^[A-Za-z][A-Za-z0-9_]{0,100}$"
inputs[].selector.definitionstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 500
inputs[].selector.unitstringObrigatório no objeto pai
  • enum: ["count","seconds","minutes","percent","ratio"]
inputs[].selector.grainstringObrigatório no objeto pai
  • enum: ["post","account"]
inputs[].selector.measurementKindstringObrigatório no objeto pai
  • enum: ["lifetime","snapshot","period","unknown"]
inputs[].selector.nativePeriodstring | nullObrigatório no objeto pai—
inputs[].selector.nativePeriodanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
inputs[].selector.nativePeriodanyOf 2nullObrigatório no objeto pai—
inputs[].selector.timezonestring | nullObrigatório no objeto pai—
inputs[].selector.timezoneanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
inputs[].selector.timezoneanyOf 2nullObrigatório no objeto pai—
inputs[].valuenumber | nullObrigatório no objeto pai—
inputs[].availabilitystringObrigatório no objeto pai
  • enum: ["available","partial","not_returned","unsupported","permission_required","threshold_not_met","no_data","failed","pending","stale"]
inputs[].reasonstring | nullObrigatório no objeto pai—
inputs[].reasonanyOf 1stringObrigatório no objeto pai
  • maxLength: 8000
inputs[].reasonanyOf 2nullObrigatório no objeto pai—
inputs[].measurementobjectObrigatório no objeto pai
  • additionalProperties: false
inputs[].measurement.kindstringObrigatório no objeto pai
  • enum: ["lifetime","snapshot","period","unknown"]
inputs[].measurement.periodstring | nullObrigatório no objeto pai—
inputs[].measurement.periodanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
inputs[].measurement.periodanyOf 2nullObrigatório no objeto pai—
inputs[].measurement.startstring | nullObrigatório no objeto pai—
inputs[].measurement.startanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
inputs[].measurement.startanyOf 2nullObrigatório no objeto pai—
inputs[].measurement.endstring | nullObrigatório no objeto pai—
inputs[].measurement.endanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 64
inputs[].measurement.endanyOf 2nullObrigatório no objeto pai—
inputs[].measurement.timezonestring | nullObrigatório no objeto pai—
inputs[].measurement.timezoneanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 100
inputs[].measurement.timezoneanyOf 2nullObrigatório no objeto pai—
inputs[].requestIdstring | nullObrigatório no objeto pai—
inputs[].requestIdanyOf 1stringObrigatório no objeto pai
  • format: "uuid"
inputs[].requestIdanyOf 2nullObrigatório no objeto pai—
inputs[].sourcePathstringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 1000
inputs[].accountIdstringObrigatório no objeto pai
  • format: "uuid"
inputs[].providerResourceIdstring | nullObrigatório no objeto pai—
inputs[].providerResourceIdanyOf 1stringObrigatório no objeto pai
  • minLength: 1
  • maxLength: 512
inputs[].providerResourceIdanyOf 2nullObrigatório no objeto pai—
inputs[].fetchedAtstring | nullObrigatório no objeto pai—
inputs[].fetchedAtanyOf 1stringObrigatório no objeto pai
  • 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)))$"
inputs[].fetchedAtanyOf 2nullObrigatório no objeto pai—
inputs[].identifierstringObrigatório no objeto pai
  • pattern: "^[a-z][a-z0-9_]{0,63}$"
inputs[].includedbooleanObrigatório no objeto pai—
JSON Schema completo
{
  "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"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Exemplo de chamada de ferramenta

Estes exemplos usam valores fictícios verificados conforme os schemas. Substitua os IDs por aqueles que você tem autorização para usar, a mídia por ativos prontos e as datas pelo horário de publicação confirmado. Confira a elegibilidade da conta antes de enviar uma gravação. Esta página não envia requisições de API.

{
  "name": "sosoapi_preview_custom_metric",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "formula": {
      "contractVersion": "analytics-metric/v1",
      "id": "11111111-1111-4111-8111-111111111111",
      "workspaceId": "11111111-1111-4111-8111-111111111111",
      "name": "example",
      "version": 1,
      "expression": "example",
      "fields": [],
      "rounding": {
        "decimalPlaces": 0,
        "mode": "half_away_from_zero"
      }
    },
    "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": []
    }
  }
}

structuredContent

{
  "contractVersion": "analytics-metric/v1",
  "workspaceId": "11111111-1111-4111-8111-111111111111",
  "datasetId": "example",
  "formulaId": "11111111-1111-4111-8111-111111111111",
  "name": "example",
  "version": 1,
  "expression": "example",
  "rounding": {
    "decimalPlaces": 0,
    "mode": "half_away_from_zero"
  },
  "value": 0,
  "unit": "example",
  "status": "available",
  "code": "ok",
  "reason": null,
  "excludedInputIds": [],
  "inputs": []
}
Instale ou conecte MCP