{"openapi":"3.1.0","info":{"title":"Kads Advertising API","version":"1.1.0","description":"Direct native integrations. Campaign writes prepare an operation for review; execute sends provider mutations. Connection endpoints manage authorization immediately. Features vary by network. Amounts in native mutation payloads retain native units; normalized insights spend is in account currency major units. No automatic currency conversion. Empty and partially reported totals remain null. Live provider acceptance depends on credentials and approval."},"servers":[{"url":"/api/v1/ads"}],"security":[{"advertisingToken":[]}],"paths":{"/connected-agents":{"get":{"summary":"List your OAuth agent grants in the current workspace","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_connected_agents"}},"/connected-agents/{grantId}":{"delete":{"summary":"Revoke one OAuth agent grant immediately","parameters":[{"name":"grantId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_connected_agents_grantId"}},"/auth/verify":{"get":{"summary":"Verify the current credential and inspect its workspace and write scope","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_auth_verify"}},"/keys":{"get":{"summary":"List your workspace API keys without revealing secrets","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_keys"},"post":{"summary":"Create an independent workspace API key as an administrator; returns secret once, expiry bounded by the authorizing key","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["name"],"properties":{"name":{"type":"string","minLength":1,"maxLength":80},"canWrite":{"type":"boolean","default":false},"expiresAt":{"type":"string","format":"date-time"}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_keys"}},"/keys/{keyId}":{"delete":{"summary":"Revoke one API key you own; other independently issued keys remain unchanged","parameters":[{"name":"keyId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_keys_keyId"}},"/bulk-edit":{"post":{"summary":"Change one money or number setting (budget, default bid…) on up to 50 items: set a value, or raise or lower each by a percentage. Use field \"bid\" for the amount of each item's bid strategy (bid cap, cost cap, target CPA, manual CPC) where the bid isn't a settings field. Prepares one reviewed edit per item","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"accountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["campaign","adGroup","ad"]},"entityIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":250}},"field":{"type":"string","minLength":1,"maxLength":60},"mode":{"type":"string","enum":["set","increase","decrease"]},"value":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["accountId","kind","entityIds","field","mode","value"],"additionalProperties":false}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_bulk_edit"}},"/bulk-status":{"post":{"summary":"Prepare up to 50 campaign, ad-group or ad status changes with separate review receipts","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"accountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["campaign","adGroup","ad"]},"entityIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":250}},"status":{"type":"string","enum":["active","paused"]}},"required":["accountId","kind","entityIds","status"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_bulk_status"}},"/operations/execute":{"post":{"summary":"Execute reviewed operations with per-operation results and safe continuation","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"operationIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"confirmed":{"type":"boolean","const":true}},"required":["operationIds","confirmed"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_operations_execute"}},"/webhooks":{"get":{"summary":"List scoped webhook subscriptions","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_webhooks"},"post":{"summary":"Register an HTTPS webhook with selected operation, account, sync or observed entity status events. Returns the signing secret once.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","maxLength":2000,"format":"uri"},"accountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"events":{"default":["operation.prepared","operation.running","operation.succeeded","operation.unknown","operation.cancelled"],"minItems":1,"maxItems":15,"type":"array","items":{"type":"string","enum":["operation.prepared","operation.running","operation.succeeded","operation.unknown","operation.cancelled","account.connected","account.disconnected","account.needs_reauth","account.ads.initial_sync_completed","analytics.synced","sync.failed","campaign.status_changed","ad_group.status_changed","ad.status_changed","rule.triggered"]}}},"required":["url"],"additionalProperties":false}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_webhooks"}},"/webhooks/{webhookId}":{"patch":{"summary":"Update webhook URL, select future event types or pause/resume delivery; queued notifications retain their original selection","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string","maxLength":2000,"format":"uri"},"active":{"type":"boolean"},"events":{"minItems":1,"maxItems":15,"type":"array","items":{"type":"string","enum":["operation.prepared","operation.running","operation.succeeded","operation.unknown","operation.cancelled","account.connected","account.disconnected","account.needs_reauth","account.ads.initial_sync_completed","analytics.synced","sync.failed","campaign.status_changed","ad_group.status_changed","ad.status_changed","rule.triggered"]}}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_webhooks_webhookId"},"delete":{"summary":"Delete a webhook and its queued deliveries","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_webhooks_webhookId"}},"/webhooks/{webhookId}/test":{"post":{"summary":"Queue a signed test notification","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_webhooks_webhookId_test"}},"/webhooks/{webhookId}/deliveries/{deliveryId}/redeliver":{"post":{"summary":"Queue a completed or failed notification again without repeating the advertising operation","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_webhooks_webhookId_deliveries_deliveryId_redeliver"}},"/webhooks/{webhookId}/deliveries/{deliveryId}/attempts":{"get":{"summary":"Read durable notification attempt history","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_webhooks_webhookId_deliveries_deliveryId_attempts"}},"/webhooks/{webhookId}/deliveries":{"get":{"summary":"Read the latest 100 delivery receipts without signing secrets","parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_webhooks_webhookId_deliveries"}},"/activate":{"post":{"summary":"Prepare activation of the complete hierarchy created by a successful campaign workflow. Execution can incur spend.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["accountId","sourceOperationId"],"properties":{"accountId":{"type":"string","format":"uuid"},"sourceOperationId":{"type":"string","format":"uuid"}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_activate"}},"/workflows":{"get":{"summary":"Discover unified campaign formats, goals, budget periods and required network inputs","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_workflows"}},"/create":{"post":{"summary":"Prepare a complete campaign workflow: budget, hierarchy, targeting and creative. Creates stay paused. Execute the returned operation after review.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["accountId","campaign"],"properties":{"accountId":{"type":"string","format":"uuid"},"campaign":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":3,"maxLength":100},"goal":{"type":"string","enum":["traffic","awareness","conversions","app_installs"]},"budget":{"type":"object","properties":{"amount":{"type":"string","pattern":"^\\d+(\\.\\d{1,6})?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"period":{"type":"string","enum":["daily","lifetime"]}},"required":["amount","currency","period"],"additionalProperties":false},"bid":{"description":"Maximum CPC/CPT in account currency. For awareness, a CPM bid except where the network capability says otherwise.","type":"string","pattern":"^\\d+(\\.\\d{1,6})?$"},"schedule":{"type":"object","properties":{"startAt":{"type":"string","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)))$"},"endAt":{"type":"string","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)))$"}},"required":["startAt"],"additionalProperties":false},"targeting":{"type":"object","properties":{"countries":{"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"locationIds":{"description":"Native location IDs from this network's catalog; never reuse IDs across networks.","maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":250}},"keywords":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":80},"match":{"default":"exact","type":"string","enum":["exact","phrase","broad"]}},"required":["text"],"additionalProperties":false}},"native":{"description":"Explicit network targeting specification for advanced targeting. Replaces the geographic shortcut; cannot be combined with countries or locationIds.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"creative":{"type":"object","properties":{"existingId":{"description":"Native creative, Pin, post, file or product-page creative ID, as documented for this network.","type":"string","minLength":1,"maxLength":250},"headline":{"type":"string","minLength":1,"maxLength":300},"body":{"type":"string","minLength":1,"maxLength":3000},"url":{"type":"string","format":"uri"},"imageUrl":{"type":"string","format":"uri"},"imageHash":{"type":"string","minLength":1,"maxLength":250},"headlines":{"minItems":3,"maxItems":15,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"descriptions":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":90}}},"additionalProperties":false},"platform":{"default":{},"type":"object","properties":{"euPoliticalAdvertising":{"type":"boolean"},"pageId":{"type":"string","minLength":1,"maxLength":250},"boardId":{"type":"string","minLength":1,"maxLength":250},"identityId":{"type":"string","minLength":1,"maxLength":250},"identityType":{"type":"string","minLength":1,"maxLength":250},"fundingInstrumentId":{"type":"string","minLength":1,"maxLength":250},"pixelId":{"type":"string","minLength":1,"maxLength":250},"conversionEvent":{"type":"string","minLength":1,"maxLength":250},"appId":{"type":"string","minLength":1,"maxLength":250},"sku":{"type":"string","minLength":1,"maxLength":250},"asin":{"type":"string","minLength":1,"maxLength":250},"brandName":{"type":"string","minLength":1,"maxLength":100},"locale":{"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$"},"language":{"type":"string","pattern":"^[a-z]{2}$"}},"required":["country","language"],"additionalProperties":false},"specialAdCategories":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1}}},"additionalProperties":false}},"required":["name","goal","budget","schedule","targeting","creative"],"additionalProperties":false}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_create"}},"/validate-campaign":{"post":{"summary":"Validate and preview a complete campaign workflow without saving or publishing","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["accountId","campaign"],"properties":{"accountId":{"type":"string","format":"uuid"},"campaign":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":3,"maxLength":100},"goal":{"type":"string","enum":["traffic","awareness","conversions","app_installs"]},"budget":{"type":"object","properties":{"amount":{"type":"string","pattern":"^\\d+(\\.\\d{1,6})?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"period":{"type":"string","enum":["daily","lifetime"]}},"required":["amount","currency","period"],"additionalProperties":false},"bid":{"description":"Maximum CPC/CPT in account currency. For awareness, a CPM bid except where the network capability says otherwise.","type":"string","pattern":"^\\d+(\\.\\d{1,6})?$"},"schedule":{"type":"object","properties":{"startAt":{"type":"string","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)))$"},"endAt":{"type":"string","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)))$"}},"required":["startAt"],"additionalProperties":false},"targeting":{"type":"object","properties":{"countries":{"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"locationIds":{"description":"Native location IDs from this network's catalog; never reuse IDs across networks.","maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":250}},"keywords":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":80},"match":{"default":"exact","type":"string","enum":["exact","phrase","broad"]}},"required":["text"],"additionalProperties":false}},"native":{"description":"Explicit network targeting specification for advanced targeting. Replaces the geographic shortcut; cannot be combined with countries or locationIds.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false},"creative":{"type":"object","properties":{"existingId":{"description":"Native creative, Pin, post, file or product-page creative ID, as documented for this network.","type":"string","minLength":1,"maxLength":250},"headline":{"type":"string","minLength":1,"maxLength":300},"body":{"type":"string","minLength":1,"maxLength":3000},"url":{"type":"string","format":"uri"},"imageUrl":{"type":"string","format":"uri"},"imageHash":{"type":"string","minLength":1,"maxLength":250},"headlines":{"minItems":3,"maxItems":15,"type":"array","items":{"type":"string","minLength":1,"maxLength":30}},"descriptions":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":90}}},"additionalProperties":false},"platform":{"default":{},"type":"object","properties":{"euPoliticalAdvertising":{"type":"boolean"},"pageId":{"type":"string","minLength":1,"maxLength":250},"boardId":{"type":"string","minLength":1,"maxLength":250},"identityId":{"type":"string","minLength":1,"maxLength":250},"identityType":{"type":"string","minLength":1,"maxLength":250},"fundingInstrumentId":{"type":"string","minLength":1,"maxLength":250},"pixelId":{"type":"string","minLength":1,"maxLength":250},"conversionEvent":{"type":"string","minLength":1,"maxLength":250},"appId":{"type":"string","minLength":1,"maxLength":250},"sku":{"type":"string","minLength":1,"maxLength":250},"asin":{"type":"string","minLength":1,"maxLength":250},"brandName":{"type":"string","minLength":1,"maxLength":100},"locale":{"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$"},"language":{"type":"string","pattern":"^[a-z]{2}$"}},"required":["country","language"],"additionalProperties":false},"specialAdCategories":{"maxItems":10,"type":"array","items":{"type":"string","minLength":1}}},"additionalProperties":false}},"required":["name","goal","budget","schedule","targeting","creative"],"additionalProperties":false}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_validate_campaign"}},"/connections":{"get":{"summary":"List connections without exposing stored credentials","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_connections"}},"/connections/authorize":{"post":{"summary":"Create a single-use hosted OAuth link using Kads-owned developer apps; no Kads browser login required","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["network"],"properties":{"network":{"type":"string","enum":["meta","google","tiktok","snapchat","pinterest","linkedin","reddit","amazon","x"]}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_connections_authorize"}},"/connections/credentials":{"post":{"summary":"Connect native account credentials; requires a workspace admin and write-enabled token","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","additionalProperties":false,"required":["network","apiKey"],"properties":{"network":{"const":"chatgpt"},"apiKey":{"type":"string","writeOnly":true}}},{"type":"object","additionalProperties":false,"required":["network","apiKey"],"description":"An OB-TOKEN-V1 token from Outbrain's token page (https://my.outbrain.com/create-token).","properties":{"network":{"const":"outbrain"},"apiKey":{"type":"string","writeOnly":true}}},{"type":"object","additionalProperties":false,"required":["network","username","password"],"description":"The Outbrain login, exchanged once for a 30-day token (GET /login). The password is never stored.","properties":{"network":{"const":"outbrain"},"username":{"type":"string"},"password":{"type":"string","writeOnly":true}}},{"type":"object","additionalProperties":false,"required":["network","clientId","teamId","keyId","privateKey"],"properties":{"network":{"const":"apple"},"clientId":{"type":"string"},"teamId":{"type":"string"},"keyId":{"type":"string"},"privateKey":{"type":"string","writeOnly":true}}}]}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_connections_credentials"}},"/connections/{connectionId}":{"delete":{"summary":"Revoke saved connection credentials without changing running campaigns","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_connections_connectionId"}},"/networks":{"get":{"summary":"Discover the 12 enabled networks and native requirements","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_networks"}},"/networks/{network}":{"get":{"summary":"Read native formats, templates, catalogs, units and limitations","parameters":[{"name":"network","in":"path","required":true,"schema":{"type":"string","enum":["meta","google","tiktok","snapchat","pinterest","linkedin","reddit","amazon","x","chatgpt","apple","outbrain"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_networks_network"}},"/accounts":{"get":{"summary":"List accessible accounts","parameters":[{"name":"network","in":"query","required":false,"schema":{"type":"string","enum":["meta","google","tiktok","snapchat","pinterest","linkedin","reddit","amazon","x","chatgpt","apple","outbrain"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts"}},"/accounts/{accountId}":{"get":{"summary":"Read one accessible account","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId"}},"/accounts/{accountId}/tree":{"get":{"summary":"Read the native hierarchy with explicit levels and parent keys","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_tree"}},"/accounts/{accountId}/insights":{"get":{"summary":"Read normalized daily metrics with native rows, coverage and pending report state","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_insights"}},"/accounts/{accountId}/catalogs/{resource}":{"get":{"summary":"Read an allowlisted catalog or resume an existing report/media job","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"resource","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z_]+(?::[a-zA-Z0-9_-]+)?$"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_catalogs_resource"}},"/accounts/{accountId}/validate":{"post":{"summary":"Validate a native mutation locally without storing it or writing to the provider","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mutation"}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_validate"}},"/operations":{"get":{"summary":"Read the latest 50 operations in the actor's scope","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_operations"}},"/operations/{operationId}":{"get":{"summary":"Read one operation and its saved receipt","parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_operations_operationId"}},"/operations/{operationId}/execute":{"post":{"summary":"Execute an explicitly reviewed operation; successful replays return the saved receipt","parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["confirmed"],"properties":{"confirmed":{"type":"boolean","const":true}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_operations_operationId_execute"}},"/operations/{operationId}/cancel":{"post":{"summary":"Cancel your own prepared operation","parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_operations_operationId_cancel"}},"/accounts/{accountId}/campaigns":{"get":{"summary":"List campaigns; unsupported resources return 422","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"parentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"Native status"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_campaigns"},"post":{"summary":"Prepare native campaigns creation","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_campaigns"}},"/accounts/{accountId}/campaigns/{entityId}":{"get":{"summary":"Read native campaigns entity","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_campaigns_entityId"},"delete":{"summary":"Prepare native campaigns deletion; discover network capabilities first","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_accounts_accountId_campaigns_entityId"},"patch":{"summary":"Prepare native campaigns update","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_accounts_accountId_campaigns_entityId"}},"/accounts/{accountId}/campaigns/{entityId}/settings":{"get":{"summary":"Read what this campaign can change from Kads: fields with current values and lock reasons, audience (targeting), bidding, ad content and network notes. Read it before editing","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_campaigns_entityId_settings"}},"/accounts/{accountId}/campaigns/{entityId}/edit":{"post":{"summary":"Prepare an edit of a campaign: rename it; change budget, schedule, bid strategy (target CPA, target ROAS, cost cap, manual CPC…), spend cap, frequency cap, conversion goals and, on networks that target at campaign level (LinkedIn), its audience. One plain-language update of fields, audience and bidding, checked against the network's own rules (locks, limits, unsupported settings) and prepared for review; money is in account currency. The Kads edit panel saves through this same command. Execute the returned operation after review.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":5000},{"type":"number"}]}},"targeting":{"type":"object","properties":{"locations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedLocations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"ageMin":{"type":"integer","minimum":13,"maximum":65},"ageMax":{"type":"integer","minimum":13,"maximum":65},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["female","male","unknown"]}},"languages":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"interests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedInterests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"audiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedAudiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"keywords":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"broad","type":"string","enum":["exact","phrase","broad"]},"negative":{"default":false,"type":"boolean"},"bid":{"type":"number","exclusiveMinimum":0}},"required":["text"],"additionalProperties":false}},"devices":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"facets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"excludedFacets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"facetGroups":{"maxItems":30,"type":"array","items":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}}},"expansion":{"type":"boolean"},"placements":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"positions":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}}},"required":["mode"],"additionalProperties":false}},"additionalProperties":false},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_campaigns_entityId_edit"}},"/accounts/{accountId}/campaigns/{entityId}/duplicate":{"post":{"summary":"Prepare a duplicate (paused copy) of a campaign, with its ad groups and ads when deep is true","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deep":{"default":true,"type":"boolean"},"nameSuffix":{"type":"string","minLength":1,"maxLength":100}},"required":["deep"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_campaigns_entityId_duplicate"}},"/accounts/{accountId}/campaigns/{entityId}/status":{"post":{"summary":"Prepare to pause or turn on (activate, enable, resume, turn off) a campaign; the status change waits for review","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"status":{"type":"string","enum":["active","paused"]}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_campaigns_entityId_status"}},"/accounts/{accountId}/ad-groups":{"get":{"summary":"List ad-groups; unsupported resources return 422","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"parentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"Native status"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_ad_groups"},"post":{"summary":"Prepare native ad-groups creation","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_ad_groups"}},"/accounts/{accountId}/ad-groups/{entityId}":{"get":{"summary":"Read native ad-groups entity","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_ad_groups_entityId"},"delete":{"summary":"Prepare native ad-groups deletion; discover network capabilities first","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_accounts_accountId_ad_groups_entityId"},"patch":{"summary":"Prepare native ad-groups update","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_accounts_accountId_ad_groups_entityId"}},"/accounts/{accountId}/ad-groups/{entityId}/settings":{"get":{"summary":"Read what this ad group (ad set, ad squad, campaign group on LinkedIn) can change from Kads: fields with current values and lock reasons, audience (targeting), bidding, ad content and network notes. Read it before editing","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_ad_groups_entityId_settings"}},"/accounts/{accountId}/ad-groups/{entityId}/edit":{"post":{"summary":"Prepare an edit of a ad group (ad set, ad squad, campaign group on LinkedIn): rename it; change budget, schedule and dayparting, bid or bid strategy (target CPA, cost cap, bid cap, manual CPC…), frequency cap, optimisation, and the audience: locations, age, gender, languages, interests, keywords and negative keywords, custom and lookalike audiences, devices and placements. One plain-language update of fields, audience and bidding, checked against the network's own rules (locks, limits, unsupported settings) and prepared for review; money is in account currency. The Kads edit panel saves through this same command. Execute the returned operation after review.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":5000},{"type":"number"}]}},"targeting":{"type":"object","properties":{"locations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedLocations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"ageMin":{"type":"integer","minimum":13,"maximum":65},"ageMax":{"type":"integer","minimum":13,"maximum":65},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["female","male","unknown"]}},"languages":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"interests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedInterests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"audiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedAudiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"keywords":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"broad","type":"string","enum":["exact","phrase","broad"]},"negative":{"default":false,"type":"boolean"},"bid":{"type":"number","exclusiveMinimum":0}},"required":["text"],"additionalProperties":false}},"devices":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"facets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"excludedFacets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"facetGroups":{"maxItems":30,"type":"array","items":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}}},"expansion":{"type":"boolean"},"placements":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"positions":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}}},"required":["mode"],"additionalProperties":false}},"additionalProperties":false},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_ad_groups_entityId_edit"}},"/accounts/{accountId}/ad-groups/{entityId}/duplicate":{"post":{"summary":"Prepare a duplicate (paused copy) of a ad group (ad set, ad squad, campaign group on LinkedIn), with its ad groups and ads when deep is true","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deep":{"default":true,"type":"boolean"},"nameSuffix":{"type":"string","minLength":1,"maxLength":100}},"required":["deep"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_ad_groups_entityId_duplicate"}},"/accounts/{accountId}/ad-groups/{entityId}/status":{"post":{"summary":"Prepare to pause or turn on (activate, enable, resume, turn off) a ad group (ad set, ad squad, campaign group on LinkedIn); the status change waits for review","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"status":{"type":"string","enum":["active","paused"]}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_ad_groups_entityId_status"}},"/accounts/{accountId}/ads":{"get":{"summary":"List ads; unsupported resources return 422","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"parentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"Native status"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_ads"},"post":{"summary":"Prepare native ads creation","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_ads"}},"/accounts/{accountId}/ads/{entityId}":{"get":{"summary":"Read native ads entity","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_ads_entityId"},"delete":{"summary":"Prepare native ads deletion; discover network capabilities first","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_accounts_accountId_ads_entityId"},"patch":{"summary":"Prepare native ads update","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_accounts_accountId_ads_entityId"}},"/accounts/{accountId}/ads/{entityId}/settings":{"get":{"summary":"Read what this ad can change from Kads: fields with current values and lock reasons, audience (targeting), bidding, ad content and network notes. Read it before editing","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_ads_entityId_settings"}},"/accounts/{accountId}/ads/{entityId}/edit":{"post":{"summary":"Prepare an edit of a ad: rename it; change ad text, headline, description, link (URL), call to action and tracking. One plain-language update of fields, audience and bidding, checked against the network's own rules (locks, limits, unsupported settings) and prepared for review; money is in account currency. The Kads edit panel saves through this same command. Execute the returned operation after review.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":5000},{"type":"number"}]}},"targeting":{"type":"object","properties":{"locations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedLocations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"ageMin":{"type":"integer","minimum":13,"maximum":65},"ageMax":{"type":"integer","minimum":13,"maximum":65},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["female","male","unknown"]}},"languages":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"interests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedInterests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"audiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedAudiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"keywords":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"broad","type":"string","enum":["exact","phrase","broad"]},"negative":{"default":false,"type":"boolean"},"bid":{"type":"number","exclusiveMinimum":0}},"required":["text"],"additionalProperties":false}},"devices":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"facets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"excludedFacets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"facetGroups":{"maxItems":30,"type":"array","items":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}}},"expansion":{"type":"boolean"},"placements":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"positions":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}}},"required":["mode"],"additionalProperties":false}},"additionalProperties":false},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_ads_entityId_edit"}},"/accounts/{accountId}/ads/{entityId}/duplicate":{"post":{"summary":"Prepare a duplicate (paused copy) of a ad, with its creative when deep is true","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"deep":{"default":true,"type":"boolean"},"nameSuffix":{"type":"string","minLength":1,"maxLength":100}},"required":["deep"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_ads_entityId_duplicate"}},"/accounts/{accountId}/ads/{entityId}/status":{"post":{"summary":"Prepare to pause or turn on (activate, enable, resume, turn off) a ad; the status change waits for review","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["status"],"properties":{"status":{"type":"string","enum":["active","paused"]}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_ads_entityId_status"}},"/accounts/{accountId}/creatives":{"get":{"summary":"List creatives; unsupported resources return 422","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"parentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"Native status"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_creatives"},"post":{"summary":"Prepare native creatives creation","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_creatives"}},"/accounts/{accountId}/creatives/{entityId}":{"get":{"summary":"Read native creatives entity","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_creatives_entityId"},"delete":{"summary":"Prepare native creatives deletion; discover network capabilities first","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_accounts_accountId_creatives_entityId"},"patch":{"summary":"Prepare native creatives update","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_accounts_accountId_creatives_entityId"}},"/accounts/{accountId}/budgets":{"get":{"summary":"List budgets; unsupported resources return 422","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"parentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"Native status"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_budgets"},"post":{"summary":"Prepare native budgets creation","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_budgets"}},"/accounts/{accountId}/budgets/{entityId}":{"get":{"summary":"Read native budgets entity","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_budgets_entityId"},"delete":{"summary":"Prepare native budgets deletion; discover network capabilities first","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_accounts_accountId_budgets_entityId"},"patch":{"summary":"Prepare native budgets update","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_accounts_accountId_budgets_entityId"}},"/accounts/{accountId}/budgets/{entityId}/settings":{"get":{"summary":"Read what this shared budget (Google, Outbrain) or Taboola campaign group can change from Kads: fields with current values and lock reasons, audience (targeting), bidding, ad content and network notes. Read it before editing","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_budgets_entityId_settings"}},"/accounts/{accountId}/budgets/{entityId}/edit":{"post":{"summary":"Prepare an edit of a shared budget (Google, Outbrain) or Taboola campaign group: change the amount, dates and pacing of a budget several campaigns share. One plain-language update of fields, audience and bidding, checked against the network's own rules (locks, limits, unsupported settings) and prepared for review; money is in account currency. The Kads edit panel saves through this same command. Execute the returned operation after review.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":5000},{"type":"number"}]}},"targeting":{"type":"object","properties":{"locations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedLocations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"ageMin":{"type":"integer","minimum":13,"maximum":65},"ageMax":{"type":"integer","minimum":13,"maximum":65},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["female","male","unknown"]}},"languages":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"interests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedInterests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"audiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedAudiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"keywords":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"broad","type":"string","enum":["exact","phrase","broad"]},"negative":{"default":false,"type":"boolean"},"bid":{"type":"number","exclusiveMinimum":0}},"required":["text"],"additionalProperties":false}},"devices":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"facets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"excludedFacets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"facetGroups":{"maxItems":30,"type":"array","items":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}}},"expansion":{"type":"boolean"},"placements":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"positions":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}}},"required":["mode"],"additionalProperties":false}},"additionalProperties":false},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_budgets_entityId_edit"}},"/accounts/{accountId}/criteria":{"get":{"summary":"List criteria; unsupported resources return 422","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"parentId","in":"query","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","description":"Native status"}},{"name":"search","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_criteria"},"post":{"summary":"Prepare native criteria creation","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_criteria"}},"/accounts/{accountId}/criteria/{entityId}":{"get":{"summary":"Read native criteria entity","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_criteria_entityId"},"delete":{"summary":"Prepare native criteria deletion; discover network capabilities first","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_accounts_accountId_criteria_entityId"},"patch":{"summary":"Prepare native criteria update","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"entityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true}}}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_accounts_accountId_criteria_entityId"}},"/networks/{network}/features":{"get":{"summary":"Read everything a network lets you build and change: editable fields per level, audience dimensions (locations, age, gender, interests, job titles, keywords, placements…), bid strategies (target CPA, target ROAS, cost cap, manual CPC…), objectives, campaign types, ad formats (single image, video, carousel, collection, lead form, search ads, catalog…) and required declarations, plus reporting breakdowns, estimates, media limits and account resources (pixels, conversions, lead forms, catalogs)","parameters":[{"name":"network","in":"path","required":true,"schema":{"type":"string","enum":["meta","google","tiktok","snapchat","pinterest","linkedin","reddit","amazon","x","chatgpt","apple","outbrain"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_networks_network_features"}},"/media":{"get":{"summary":"List the workspace's media library (images and videos) to use in campaign specs as media.libraryId. Each network's features.media says how a file reaches it (uploaded to its asset store or sent as a link), its limits, and which formats or fields take it","parameters":[{"name":"kind","in":"query","required":false,"schema":{"type":"string","enum":["image","video"]}},{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":200}},{"name":"folderId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"before","in":"query","required":false,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"get_media"},"post":{"summary":"Upload an image or video (add a file) to the workspace media library from a public HTTPS URL or inline base64 (up to 20 MB). Nothing is sent to an ad network: reference it as media.libraryId in a campaign spec and Kads uploads it as a reviewed step","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"folderId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"url":{"type":"string","format":"uri"},"dataBase64":{"type":"string","maxLength":27962031,"pattern":"^[A-Za-z0-9+/]*={0,2}$"},"mimeType":{"type":"string","enum":["image/jpeg","image/png","image/webp","video/mp4","video/quicktime"]}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_media"}},"/accounts/{accountId}/targeting-search":{"post":{"summary":"Search a network's audience catalog (locations, interests, job titles, keywords, pixels, pages…) named by the network's features. Pass context (the item being edited) for catalogs that recommend for it, such as suggested keywords and bids","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"catalog":{"type":"string","maxLength":80,"pattern":"^[a-zA-Z_:-]+$"},"query":{"type":"string","maxLength":200},"context":{"type":"object","properties":{"kind":{"type":"string","enum":["campaign","adGroup","ad","creative","budget","criterion"]},"entityId":{"type":"string","minLength":1,"maxLength":250}},"required":["kind","entityId"],"additionalProperties":false}},"required":["catalog","query"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_targeting_search"}},"/accounts/{accountId}/estimates":{"post":{"summary":"Estimate a draft audience before or while editing it: audience size (reach), the network's suggested bid and a delivery forecast, where the network's API gives them (read features.estimates). Send the same objective, targeting, bidding, budget and schedule you would put in a campaign spec. Nothing is saved or sent for review.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kinds":{"default":["audience"],"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["audience","bid","forecast"]}},"objective":{"type":"string","maxLength":80},"campaignType":{"type":"string","maxLength":80},"goal":{"type":"string","maxLength":80},"targeting":{"default":{},"type":"object","properties":{"locations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedLocations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"ageMin":{"type":"integer","minimum":13,"maximum":65},"ageMax":{"type":"integer","minimum":13,"maximum":65},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["female","male","unknown"]}},"languages":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"interests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedInterests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"audiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedAudiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"keywords":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"broad","type":"string","enum":["exact","phrase","broad"]},"negative":{"default":false,"type":"boolean"},"bid":{"type":"number","exclusiveMinimum":0}},"required":["text"],"additionalProperties":false}},"devices":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"facets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"excludedFacets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"facetGroups":{"maxItems":30,"type":"array","items":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}}},"expansion":{"type":"boolean"},"placements":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"positions":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}}},"required":["mode"],"additionalProperties":false}},"additionalProperties":false},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false},"budget":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"period":{"type":"string","enum":["daily","lifetime","monthly"]}},"required":["amount","period"],"additionalProperties":false},"schedule":{"type":"object","properties":{"startAt":{"type":"string","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)))$"},"endAt":{"type":"string","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)))$"}},"additionalProperties":false},"format":{"type":"string","maxLength":60}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_estimates"}},"/accounts/{accountId}/breakdowns":{"post":{"summary":"Read performance split by age, gender, country, region, placement, device, hour and network-specific breakdowns (job function, community, keyword…), with an optional attribution window. Read the network's features.reporting for what it offers and which breakdowns combine. A pending result carries a reportId: send the same request again with resume set to it.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"range":{"type":"object","properties":{"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["startDate","endDate"],"additionalProperties":false},"breakdowns":{"default":[],"maxItems":3,"type":"array","items":{"type":"string","enum":["age","gender","country","region","dma","county","city","placement","publisherPlatform","device","os","hour","dayOfWeek","day","week","month","network","language","interest","audience","keyword","jobFunction","seniority","company","companySize","industry","jobTitle","community","site","browser","product","purchasedProduct","productGroup","conversionEvent","asset","card","searchTerm"]}},"level":{"default":"campaign","type":"string","enum":["account","campaign","adGroup","ad"]},"filter":{"type":"object","properties":{"campaignIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":250}},"adGroupIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":250}}},"additionalProperties":false},"attribution":{"type":"object","properties":{"click":{"type":"string","enum":["none","1h","3h","6h","1d","7d","14d","28d","30d","60d"]},"view":{"type":"string","enum":["none","1h","3h","6h","1d","7d","14d","28d","30d","60d"]},"engagement":{"type":"string","enum":["none","1h","3h","6h","1d","7d","14d","28d","30d","60d"]},"reportTime":{"type":"string","enum":["impression","conversion"]}},"additionalProperties":false},"resume":{"type":"string","minLength":1,"maxLength":2000,"pattern":"^[A-Za-z0-9_:.+,=-]+$"}},"required":["range"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_breakdowns"}},"/accounts/{accountId}/search-terms":{"post":{"summary":"Read the searches that triggered search ads (Google, Amazon, Apple and others that report them), with the keyword that matched, metrics and which one-click keyword actions each term allows","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"range":{"type":"object","properties":{"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["startDate","endDate"],"additionalProperties":false},"level":{"default":"adGroup","type":"string","enum":["campaign","adGroup"]},"filter":{"type":"object","properties":{"campaignIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":250}},"adGroupIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":250}}},"additionalProperties":false},"attribution":{"type":"object","properties":{"click":{"type":"string","enum":["none","1h","3h","6h","1d","7d","14d","28d","30d","60d"]},"view":{"type":"string","enum":["none","1h","3h","6h","1d","7d","14d","28d","30d","60d"]},"engagement":{"type":"string","enum":["none","1h","3h","6h","1d","7d","14d","28d","30d","60d"]},"reportTime":{"type":"string","enum":["impression","conversion"]}},"additionalProperties":false},"resume":{"type":"string","minLength":1,"maxLength":2000,"pattern":"^[A-Za-z0-9_:.+,=-]+$"}},"required":["range"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_search_terms"}},"/accounts/{accountId}/search-terms/keywords":{"post":{"summary":"Prepare adding a search term as a keyword or negative keyword (ad group, or the whole campaign for negatives) for review. Nothing changes on the network until the operation is executed.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"term":{"type":"string","minLength":1,"maxLength":200},"adGroupId":{"type":"string","minLength":1,"maxLength":250},"campaignId":{"type":"string","minLength":1,"maxLength":250},"match":{"type":"string","enum":["exact","phrase","broad"]},"negative":{"default":false,"type":"boolean"},"scope":{"default":"adGroup","type":"string","enum":["adGroup","campaign"]},"bid":{"type":"number","exclusiveMinimum":0}},"required":["term","adGroupId","match"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_search_terms_keywords"}},"/accounts/{accountId}/campaign-specs":{"post":{"summary":"Prepare a complete campaign from one network-neutral spec: objective, campaign type, budget, schedule and dayparting (ad schedule), bidding, ad sets with audience, and ads in any format the network offers (single image, video, carousel, collection, lead form, search ads, catalog…; read the network's features). Everything is created paused; execute after review.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spec":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"objective":{"type":"string","minLength":1,"maxLength":80},"campaignType":{"type":"string","maxLength":80},"existingCampaignId":{"type":"string","minLength":1,"maxLength":250},"existingAdGroupId":{"type":"string","minLength":1,"maxLength":250},"budget":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"period":{"type":"string","enum":["daily","lifetime","monthly"]},"monthly":{"type":"boolean"},"level":{"default":"adGroup","type":"string","enum":["campaign","adGroup"]}},"required":["amount","period"],"additionalProperties":false},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false},"schedule":{"type":"object","properties":{"startAt":{"type":"string","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)))$"},"endAt":{"type":"string","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)))$"},"dayparting":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$|^24:00$"}},"required":["days","start","end"],"additionalProperties":false}}},"required":["startAt"],"additionalProperties":false},"declarations":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"string","maxLength":200},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":100}}]}},"adGroups":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"targeting":{"default":{},"type":"object","properties":{"locations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedLocations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"ageMin":{"type":"integer","minimum":13,"maximum":65},"ageMax":{"type":"integer","minimum":13,"maximum":65},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["female","male","unknown"]}},"languages":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"interests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedInterests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"audiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedAudiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"keywords":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"broad","type":"string","enum":["exact","phrase","broad"]},"negative":{"default":false,"type":"boolean"},"bid":{"type":"number","exclusiveMinimum":0}},"required":["text"],"additionalProperties":false}},"devices":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"facets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"excludedFacets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"facetGroups":{"maxItems":30,"type":"array","items":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}}},"expansion":{"type":"boolean"},"placements":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"positions":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}}},"required":["mode"],"additionalProperties":false}},"additionalProperties":false},"budget":{"type":"number","exclusiveMinimum":0},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false},"settings":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"},{"type":"boolean"}]}},"optimization":{"default":{},"type":"object","properties":{"goal":{"type":"string","maxLength":80},"pixelId":{"type":"string","maxLength":200},"event":{"type":"string","maxLength":200},"promotedObject":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"type":"string","maxLength":300}}},"additionalProperties":false},"ads":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"format":{"type":"string","enum":["single_image","single_video","carousel","collection","existing_post","text_post","catalog","search_text","responsive_display","document","lead_form","product","store_spotlight","app","native_article","rss_feed","quiz","existing_creative","story","call","message","flexible","text_ad","spotlight","follower","event","lens"]},"texts":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":3000}},"headlines":{"default":[],"maxItems":15,"type":"array","items":{"type":"string","minLength":1,"maxLength":300}},"descriptions":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":1000}},"url":{"type":"string","format":"uri"},"displayUrl":{"type":"string","minLength":1,"maxLength":255},"urlParameters":{"type":"string","minLength":1,"maxLength":1000},"cta":{"type":"string","maxLength":60},"media":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"assetId":{"type":"string","minLength":1,"maxLength":300},"libraryId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"default":"image","type":"string","enum":["image","video"]}},"additionalProperties":false},"cards":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"headline":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","minLength":1,"maxLength":1000},"url":{"type":"string","format":"uri"},"media":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"assetId":{"type":"string","minLength":1,"maxLength":300},"libraryId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"default":"image","type":"string","enum":["image","video"]}},"additionalProperties":false}},"additionalProperties":false}},"existingId":{"type":"string","minLength":1,"maxLength":300},"identity":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"type":"string","maxLength":300}},"enhancements":{"type":"boolean"},"enhancementFeatures":{"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}},"trackingUrls":{"type":"object","properties":{"impression":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}},"click":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}}},"additionalProperties":false},"assets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"assetId":{"type":"string","minLength":1,"maxLength":300},"libraryId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"default":"image","type":"string","enum":["image","video"]}},"additionalProperties":false}}},"required":["format"],"additionalProperties":false}}},"required":["name","ads"],"additionalProperties":false}}},"required":["name","objective","budget","schedule","adGroups"],"additionalProperties":false}},"required":["spec"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_campaign_specs"}},"/accounts/{accountId}/campaign-specs/validate":{"post":{"summary":"Validate a campaign spec against the network's rules and preview the native steps without saving","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spec":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"objective":{"type":"string","minLength":1,"maxLength":80},"campaignType":{"type":"string","maxLength":80},"existingCampaignId":{"type":"string","minLength":1,"maxLength":250},"existingAdGroupId":{"type":"string","minLength":1,"maxLength":250},"budget":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"period":{"type":"string","enum":["daily","lifetime","monthly"]},"monthly":{"type":"boolean"},"level":{"default":"adGroup","type":"string","enum":["campaign","adGroup"]}},"required":["amount","period"],"additionalProperties":false},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false},"schedule":{"type":"object","properties":{"startAt":{"type":"string","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)))$"},"endAt":{"type":"string","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)))$"},"dayparting":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"integer","minimum":0,"maximum":6}},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$|^24:00$"}},"required":["days","start","end"],"additionalProperties":false}}},"required":["startAt"],"additionalProperties":false},"declarations":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"string","maxLength":200},{"maxItems":20,"type":"array","items":{"type":"string","maxLength":100}}]}},"adGroups":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"targeting":{"default":{},"type":"object","properties":{"locations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedLocations":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"ageMin":{"type":"integer","minimum":13,"maximum":65},"ageMax":{"type":"integer","minimum":13,"maximum":65},"genders":{"maxItems":3,"type":"array","items":{"type":"string","enum":["female","male","unknown"]}},"languages":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"interests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedInterests":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"audiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"excludedAudiences":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"keywords":{"maxItems":2000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200},"match":{"default":"broad","type":"string","enum":["exact","phrase","broad"]},"negative":{"default":false,"type":"boolean"},"bid":{"type":"number","exclusiveMinimum":0}},"required":["text"],"additionalProperties":false}},"devices":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}},"facets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"excludedFacets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":300},"name":{"type":"string","minLength":1,"maxLength":300},"type":{"type":"string","maxLength":60},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":1000},"meta":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","name"],"additionalProperties":false}}},"facetGroups":{"maxItems":30,"type":"array","items":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}}},"expansion":{"type":"boolean"},"placements":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"positions":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","maxLength":100}}},"required":["mode"],"additionalProperties":false}},"additionalProperties":false},"budget":{"type":"number","exclusiveMinimum":0},"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false},"settings":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"anyOf":[{"type":"string","maxLength":300},{"type":"number"},{"type":"boolean"}]}},"optimization":{"default":{},"type":"object","properties":{"goal":{"type":"string","maxLength":80},"pixelId":{"type":"string","maxLength":200},"event":{"type":"string","maxLength":200},"promotedObject":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"type":"string","maxLength":300}}},"additionalProperties":false},"ads":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"format":{"type":"string","enum":["single_image","single_video","carousel","collection","existing_post","text_post","catalog","search_text","responsive_display","document","lead_form","product","store_spotlight","app","native_article","rss_feed","quiz","existing_creative","story","call","message","flexible","text_ad","spotlight","follower","event","lens"]},"texts":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":3000}},"headlines":{"default":[],"maxItems":15,"type":"array","items":{"type":"string","minLength":1,"maxLength":300}},"descriptions":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":1000}},"url":{"type":"string","format":"uri"},"displayUrl":{"type":"string","minLength":1,"maxLength":255},"urlParameters":{"type":"string","minLength":1,"maxLength":1000},"cta":{"type":"string","maxLength":60},"media":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"assetId":{"type":"string","minLength":1,"maxLength":300},"libraryId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"default":"image","type":"string","enum":["image","video"]}},"additionalProperties":false},"cards":{"default":[],"maxItems":20,"type":"array","items":{"type":"object","properties":{"headline":{"type":"string","minLength":1,"maxLength":300},"description":{"type":"string","minLength":1,"maxLength":1000},"url":{"type":"string","format":"uri"},"media":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"assetId":{"type":"string","minLength":1,"maxLength":300},"libraryId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"default":"image","type":"string","enum":["image","video"]}},"additionalProperties":false}},"additionalProperties":false}},"existingId":{"type":"string","minLength":1,"maxLength":300},"identity":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"type":"string","maxLength":300}},"enhancements":{"type":"boolean"},"enhancementFeatures":{"maxItems":30,"type":"array","items":{"type":"string","maxLength":60}},"trackingUrls":{"type":"object","properties":{"impression":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}},"click":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}}},"additionalProperties":false},"assets":{"type":"object","propertyNames":{"type":"string","maxLength":60},"additionalProperties":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"assetId":{"type":"string","minLength":1,"maxLength":300},"libraryId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"default":"image","type":"string","enum":["image","video"]}},"additionalProperties":false}}},"required":["format"],"additionalProperties":false}}},"required":["name","ads"],"additionalProperties":false}}},"required":["name","objective","budget","schedule","adGroups"],"additionalProperties":false}},"required":["spec"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_campaign_specs_validate"}},"/networks/{network}/audience-features":{"get":{"summary":"Read which audience types a network lets you create (customer list, website, engagement, lookalike), their identifiers, retention limits, events, lookalike countries and sizes, and what it doesn't allow","parameters":[{"name":"network","in":"path","required":true,"schema":{"type":"string","enum":["meta","google","tiktok","snapchat","pinterest","linkedin","reddit","amazon","x","chatgpt","apple","outbrain"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_networks_network_audience_features"}},"/accounts/{accountId}/audiences":{"get":{"summary":"List the account's audiences with type, status, approximate size and whether Kads can change them","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"get_accounts_accountId_audiences"},"post":{"summary":"Prepare a new audience from one network-neutral spec: a customer list (emails, phones or device IDs; raw values are normalised and SHA-256 hashed on the server, or send hashed: true with pre-hashed values), website visitors from a pixel, engagers, or a lookalike of an existing audience. Execute after review.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spec":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"customer_list"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"identifiers":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","enum":["email","phone","first_name","last_name","city","region","zip","country","birth_year","gender","maid","external_id"]}},"retentionDays":{"type":"integer","exclusiveMinimum":0,"maximum":10000},"source":{"type":"string","maxLength":60},"members":{"type":"object","properties":{"schema":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","enum":["email","phone","first_name","last_name","city","region","zip","country","birth_year","gender","maid","external_id"]}},"rows":{"minItems":1,"maxItems":100000,"type":"array","items":{"minItems":1,"maxItems":12,"type":"array","items":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}}},"hashed":{"default":false,"type":"boolean"},"defaultCountryCode":{"type":"string","pattern":"^[1-9]\\d{0,3}$"},"consent":{"type":"object","properties":{"adUserData":{"type":"boolean"},"adPersonalization":{"type":"boolean"}},"required":["adUserData","adPersonalization"],"additionalProperties":false},"termsAccepted":{"type":"boolean"}},"required":["schema","rows"],"additionalProperties":false}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"website"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"pixelId":{"type":"string","minLength":1,"maxLength":300},"retentionDays":{"type":"integer","exclusiveMinimum":0,"maximum":10000},"rules":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"event":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"object","properties":{"operator":{"type":"string","enum":["contains","equals","not_contains"]},"value":{"type":"string","minLength":1,"maxLength":500}},"required":["operator","value"],"additionalProperties":false}},"required":["event"],"additionalProperties":false}},"exclude":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"event":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"object","properties":{"operator":{"type":"string","enum":["contains","equals","not_contains"]},"value":{"type":"string","minLength":1,"maxLength":500}},"required":["operator","value"],"additionalProperties":false}},"required":["event"],"additionalProperties":false}},"prefill":{"type":"boolean"}},"required":["type","name","retentionDays","rules"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"engagement"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"source":{"type":"string","minLength":1,"maxLength":60},"sourceIds":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":300}},"action":{"type":"string","minLength":1,"maxLength":80},"retentionDays":{"type":"integer","exclusiveMinimum":0,"maximum":10000}},"required":["type","name","source","action","retentionDays"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"lookalike"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"sourceAudienceId":{"type":"string","minLength":1,"maxLength":300},"countries":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"size":{"anyOf":[{"type":"number","exclusiveMinimum":0,"maximum":100},{"type":"string","minLength":1,"maxLength":40}]}},"required":["type","name","sourceAudienceId","countries","size"],"additionalProperties":false}]}},"required":["spec"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_audiences"}},"/accounts/{accountId}/audiences/validate":{"post":{"summary":"Check an audience spec against the network's rules and preview the native steps without saving","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spec":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"customer_list"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"identifiers":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","enum":["email","phone","first_name","last_name","city","region","zip","country","birth_year","gender","maid","external_id"]}},"retentionDays":{"type":"integer","exclusiveMinimum":0,"maximum":10000},"source":{"type":"string","maxLength":60},"members":{"type":"object","properties":{"schema":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","enum":["email","phone","first_name","last_name","city","region","zip","country","birth_year","gender","maid","external_id"]}},"rows":{"minItems":1,"maxItems":100000,"type":"array","items":{"minItems":1,"maxItems":12,"type":"array","items":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}}},"hashed":{"default":false,"type":"boolean"},"defaultCountryCode":{"type":"string","pattern":"^[1-9]\\d{0,3}$"},"consent":{"type":"object","properties":{"adUserData":{"type":"boolean"},"adPersonalization":{"type":"boolean"}},"required":["adUserData","adPersonalization"],"additionalProperties":false},"termsAccepted":{"type":"boolean"}},"required":["schema","rows"],"additionalProperties":false}},"required":["type","name"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"website"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"pixelId":{"type":"string","minLength":1,"maxLength":300},"retentionDays":{"type":"integer","exclusiveMinimum":0,"maximum":10000},"rules":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"event":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"object","properties":{"operator":{"type":"string","enum":["contains","equals","not_contains"]},"value":{"type":"string","minLength":1,"maxLength":500}},"required":["operator","value"],"additionalProperties":false}},"required":["event"],"additionalProperties":false}},"exclude":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"event":{"type":"string","minLength":1,"maxLength":100},"url":{"type":"object","properties":{"operator":{"type":"string","enum":["contains","equals","not_contains"]},"value":{"type":"string","minLength":1,"maxLength":500}},"required":["operator","value"],"additionalProperties":false}},"required":["event"],"additionalProperties":false}},"prefill":{"type":"boolean"}},"required":["type","name","retentionDays","rules"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"engagement"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"source":{"type":"string","minLength":1,"maxLength":60},"sourceIds":{"default":[],"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":300}},"action":{"type":"string","minLength":1,"maxLength":80},"retentionDays":{"type":"integer","exclusiveMinimum":0,"maximum":10000}},"required":["type","name","source","action","retentionDays"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"lookalike"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500},"sourceAudienceId":{"type":"string","minLength":1,"maxLength":300},"countries":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"size":{"anyOf":[{"type":"number","exclusiveMinimum":0,"maximum":100},{"type":"string","minLength":1,"maxLength":40}]}},"required":["type","name","sourceAudienceId","countries","size"],"additionalProperties":false}]}},"required":["spec"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_audiences_validate"}},"/accounts/{accountId}/audiences/{audienceId}":{"patch":{"summary":"Prepare renaming an audience or changing its description, where the network allows it","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"audienceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"changes":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","maxLength":500}},"additionalProperties":false}},"required":["changes"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_accounts_accountId_audiences_audienceId"},"delete":{"summary":"Prepare deleting an audience (archiving on networks without delete)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"audienceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_accounts_accountId_audiences_audienceId"}},"/accounts/{accountId}/audiences/{audienceId}/members":{"post":{"summary":"Prepare adding or removing people in a customer list. members.schema names the columns (email, phone, maid…), members.rows holds one row per person. Raw values are hashed on the server with the network's rules; nothing raw is stored.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"audienceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"operation":{"type":"string","enum":["add","remove"]},"members":{"type":"object","properties":{"schema":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","enum":["email","phone","first_name","last_name","city","region","zip","country","birth_year","gender","maid","external_id"]}},"rows":{"minItems":1,"maxItems":100000,"type":"array","items":{"minItems":1,"maxItems":12,"type":"array","items":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]}}},"hashed":{"default":false,"type":"boolean"},"defaultCountryCode":{"type":"string","pattern":"^[1-9]\\d{0,3}$"},"consent":{"type":"object","properties":{"adUserData":{"type":"boolean"},"adPersonalization":{"type":"boolean"}},"required":["adUserData","adPersonalization"],"additionalProperties":false},"termsAccepted":{"type":"boolean"}},"required":["schema","rows"],"additionalProperties":false}},"required":["operation","members"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_audiences_audienceId_members"}},"/accounts/{accountId}/workflows":{"post":{"summary":"Prepare or validate a complete native campaign workflow with saved step receipts","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"workflow":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"steps":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","pattern":"^[a-zA-Z][a-zA-Z0-9_]{0,79}$"},"label":{"type":"string","minLength":1,"maxLength":200},"kind":{"type":"string","enum":["campaign","adGroup","ad","creative","budget","criterion"]},"action":{"default":"create","type":"string","enum":["create","update"]},"entityId":{"type":"string","minLength":1,"maxLength":250},"parent":{"anyOf":[{"type":"string","minLength":1,"maxLength":250},{"type":"object","properties":{"$step":{"type":"string","pattern":"^[a-zA-Z][a-zA-Z0-9_]{0,79}$"}},"required":["$step"],"additionalProperties":false}]},"payload":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["key","label","kind","action","payload"],"additionalProperties":false}}},"required":["name","steps"],"additionalProperties":false},"validateOnly":{"default":false,"type":"boolean"}},"required":["workflow","validateOnly"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_accounts_accountId_workflows"}},"/accounts/{accountId}/native-operations":{"get":{"summary":"Discover native advertising resource operations and their exact schemas","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_native_operations"}},"/accounts/{accountId}/native/meta/listAudiences":{"post":{"summary":"Read meta listAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fetch_primary_audience":{"type":"boolean"},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"filtering":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"pixel_id":{"type":"string","maxLength":100000},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listAudiences"}},"/accounts/{accountId}/native/meta/listSavedAudiences":{"post":{"summary":"Read meta listSavedAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"filtering":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listSavedAudiences"}},"/accounts/{accountId}/native/meta/listPixels":{"post":{"summary":"Read meta listPixels (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"sort_by":{"type":"string","enum":["LAST_FIRED_TIME","NAME"]},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listPixels"}},"/accounts/{accountId}/native/meta/listCustomConversions":{"post":{"summary":"Read meta listCustomConversions (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listCustomConversions"}},"/accounts/{accountId}/native/meta/getDsaRecommendations":{"post":{"summary":"Read meta getDsaRecommendations (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getDsaRecommendations"}},"/accounts/{accountId}/native/meta/generatePreviews":{"post":{"summary":"Read meta generatePreviews (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"ad_format":{"type":"string","enum":["AUDIENCE_NETWORK_INSTREAM_VIDEO","AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE","AUDIENCE_NETWORK_OUTSTREAM_VIDEO","AUDIENCE_NETWORK_REWARDED_VIDEO","BIZ_DISCO_FEED_MOBILE","DESKTOP_FEED_STANDARD","FACEBOOK_IFU_REELS_MOBILE","FACEBOOK_PROFILE_FEED_DESKTOP","FACEBOOK_PROFILE_FEED_MOBILE","FACEBOOK_PROFILE_REELS_MOBILE","FACEBOOK_REELS_BANNER","FACEBOOK_REELS_BANNER_DESKTOP","FACEBOOK_REELS_BANNER_FEED_ANDROID","FACEBOOK_REELS_BANNER_FEED_ANDROID_LARGE","FACEBOOK_REELS_BANNER_FULLSCREEN_IOS","FACEBOOK_REELS_BANNER_FULLSCREEN_MOBILE","FACEBOOK_REELS_MOBILE","FACEBOOK_REELS_POSTLOOP","FACEBOOK_REELS_POSTLOOP_FEED","FACEBOOK_REELS_SIMILAR_PRODUCTS_MOBILE","FACEBOOK_REELS_STICKER","FACEBOOK_STORY_MOBILE","FACEBOOK_STORY_STICKER_MOBILE","INSTAGRAM_EXPLORE_CONTEXTUAL","INSTAGRAM_EXPLORE_GRID_HOME","INSTAGRAM_EXPLORE_IMMERSIVE","INSTAGRAM_FEED_WEB","INSTAGRAM_FEED_WEB_M_SITE","INSTAGRAM_LEAD_GEN_MULTI_SUBMIT_ADS","INSTAGRAM_PROFILE_FEED","INSTAGRAM_PROFILE_REELS","INSTAGRAM_REELS","INSTAGRAM_REELS_OVERLAY","INSTAGRAM_REELS_WEB","INSTAGRAM_REELS_WEB_M_SITE","INSTAGRAM_SEARCH_CHAIN","INSTAGRAM_SEARCH_GRID","INSTAGRAM_STANDARD","INSTAGRAM_STORY","INSTAGRAM_STORY_EFFECT_TRAY","INSTAGRAM_STORY_WEB","INSTAGRAM_STORY_WEB_M_SITE","INSTANT_ARTICLE_RECIRCULATION_AD","INSTANT_ARTICLE_STANDARD","INSTREAM_BANNER_DESKTOP","INSTREAM_BANNER_FEED_IOS","INSTREAM_BANNER_FULLSCREEN_IOS","INSTREAM_BANNER_FULLSCREEN_MOBILE","INSTREAM_BANNER_IMMERSIVE_MOBILE","INSTREAM_BANNER_MOBILE","INSTREAM_VIDEO_DESKTOP","INSTREAM_VIDEO_FULLSCREEN_IOS","INSTREAM_VIDEO_FULLSCREEN_MOBILE","INSTREAM_VIDEO_IMAGE","INSTREAM_VIDEO_IMMERSIVE_MOBILE","INSTREAM_VIDEO_MOBILE","JOB_BROWSER_DESKTOP","JOB_BROWSER_MOBILE","MARKETPLACE_MOBILE","MESSENGER_MOBILE_INBOX_MEDIA","MESSENGER_MOBILE_STORY_MEDIA","MOBILE_BANNER","MOBILE_FEED_BASIC","MOBILE_FEED_STANDARD","MOBILE_FULLWIDTH","MOBILE_INTERSTITIAL","MOBILE_MEDIUM_RECTANGLE","MOBILE_NATIVE","RIGHT_COLUMN_STANDARD","SUGGESTED_VIDEO_DESKTOP","SUGGESTED_VIDEO_FULLSCREEN_MOBILE","SUGGESTED_VIDEO_IMMERSIVE_MOBILE","SUGGESTED_VIDEO_MOBILE","WATCH_FEED_HOME","WATCH_FEED_MOBILE","WHATSAPP_STATUS_MEDIA"]},"creative":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"creative_feature":{"type":"string","enum":["ig_video_native_subtitle","image_animation","product_browsing","product_metadata_automation","profile_card","standard_enhancements_catalog","text_overlay_translation"]},"dynamic_asset_label":{"type":"string","maxLength":100000},"dynamic_creative_spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"dynamic_customization":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"end_date":{"type":"string","maxLength":100000},"height":{"type":"integer","minimum":0,"maximum":9007199254740991},"locale":{"type":"string","maxLength":100000},"message":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"post":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"product_item_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"render_type":{"type":"string","enum":["FALLBACK"]},"start_date":{"type":"string","maxLength":100000},"width":{"type":"integer","minimum":0,"maximum":9007199254740991},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"required":["ad_format","creative"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_generatePreviews"}},"/accounts/{accountId}/native/meta/estimateReach":{"post":{"summary":"Read meta estimateReach (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adgroup_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"concepts":{"type":"string","maxLength":100000},"creative_action_spec":{"type":"string","maxLength":100000},"is_debug":{"type":"boolean"},"object_store_url":{"type":"string","maxLength":100000},"targeting_spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"required":["targeting_spec"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_estimateReach"}},"/accounts/{accountId}/native/meta/listLabels":{"post":{"summary":"Read meta listLabels (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listLabels"}},"/accounts/{accountId}/native/meta/listActivity":{"post":{"summary":"Read meta listActivity (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"add_children":{"type":"boolean"},"after":{"type":"string","maxLength":3000},"category":{"type":"string","maxLength":100000},"data_source":{"type":"string","maxLength":100000},"limit":{"type":"integer","minimum":1,"maximum":1000},"since":{"type":"string","maxLength":100000},"until":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listActivity"}},"/accounts/{accountId}/native/meta/listValueRuleSets":{"post":{"summary":"Read meta listValueRuleSets (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"product_type":{"type":"string","enum":["AUDIENCE","LEADGEN_ADS","OMNI_CHANNEL"]},"status":{"type":"string","enum":["ACTIVE","DELETED","DRAFT"]},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listValueRuleSets"}},"/accounts/{accountId}/native/meta/listPages":{"post":{"summary":"Read meta listPages (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listPages"}},"/accounts/{accountId}/native/meta/listRecommendations":{"post":{"summary":"Read meta listRecommendations (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"recommendation_names":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"recommendation_stages":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listRecommendations"}},"/accounts/{accountId}/native/meta/createAudience":{"post":{"summary":"Prepare meta createAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"allowed_domains":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"associated_audience_id":{"type":"integer","minimum":0,"maximum":9007199254740991},"audience_labels":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["APP_USERS","AT_RISK","CART_ABANDONERS","DISENGAGED","DISQUALIFIED_LEADS","ENGAGED_USERS","GENERAL_CUSTOMERS","HIGH_VALUE_CUSTOMERS","LOW_VALUE_CUSTOMERS","OTHER_1","OTHER_2","OTHER_3","QUALIFIED_LEADS","RECENT_PURCHASERS","TRIAL_USERS"]}},"claim_objective":{"type":"string","enum":["AUTOMOTIVE_MODEL","COLLABORATIVE_ADS","HOME_LISTING","MEDIA_TITLE","PRODUCT","TRAVEL","VEHICLE","VEHICLE_OFFER"]},"content_type":{"type":"string","enum":["AUTOMOTIVE_MODEL","DESTINATION","FLIGHT","GENERIC","HOME_LISTING","HOTEL","LOCAL_SERVICE_BUSINESS","MEDIA_TITLE","OFFLINE_PRODUCT","PRODUCT","VEHICLE","VEHICLE_OFFER"]},"countries":{"type":"string","maxLength":100000},"creation_params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"customer_file_source":{"type":"string","enum":["BOTH_USER_AND_PARTNER_PROVIDED","PARTNER_PROVIDED_ONLY","USER_PROVIDED_ONLY"]},"dataset_id":{"type":"string","maxLength":100000},"description":{"type":"string","maxLength":100000},"enable_fetch_or_create":{"type":"boolean"},"event_source_group":{"type":"string","maxLength":100000},"event_sources":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"exclusions":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"facebook_page_id":{"type":"string","maxLength":100000},"inclusionOperator":{"type":"string","maxLength":100000},"inclusions":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"is_snapshot":{"type":"boolean"},"is_value_based":{"type":"boolean"},"lookalike_spec":{"type":"string","maxLength":100000},"marketing_message_channels":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"name":{"type":"string","maxLength":100000},"opt_out_link":{"type":"string","maxLength":100000},"origin_audience_id":{"type":"string","maxLength":100000},"parent_audience_id":{"type":"integer","minimum":0,"maximum":9007199254740991},"partner_reference_key":{"type":"string","maxLength":100000},"pixel_id":{"type":"string","maxLength":100000},"prefill":{"type":"boolean"},"product_set_id":{"type":"string","maxLength":100000},"regulated_audience_spec":{"type":"string","maxLength":100000},"retention_days":{"type":"integer","minimum":0,"maximum":9007199254740991},"rev_share_policy_id":{"type":"integer","minimum":0,"maximum":9007199254740991},"rule":{"type":"string","maxLength":100000},"rule_aggregation":{"type":"string","maxLength":100000},"subscription_info":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["MESSENGER","WHATSAPP"]}},"subtype":{"type":"string","enum":["APP","BAG_OF_ACCOUNTS","BIDDING","CLAIM","CUSTOM","ENGAGEMENT","EXCLUSION","FOX","LOOKALIKE","MANAGED","MEASUREMENT","MESSENGER_SUBSCRIBER_LIST","OFFLINE_CONVERSION","PARTNER","PRIMARY","REGULATED_CATEGORIES_AUDIENCE","STUDY_RULE_AUDIENCE","VIDEO","WEBSITE"]},"usage_restriction":{"type":"string","enum":["EXCLUSION_ONLY","NONE","NO_DERIVATIVES"]},"use_for_products":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["ADS","MARKETING_MESSAGES"]}},"use_in_campaigns":{"type":"boolean"},"video_group_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"whats_app_business_phone_number_id":{"type":"string","maxLength":100000}},"required":["name","subtype"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createAudience"}},"/accounts/{accountId}/native/meta/createPixel":{"post":{"summary":"Prepare meta createPixel (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000}},"required":["name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createPixel"}},"/accounts/{accountId}/native/meta/createCustomConversion":{"post":{"summary":"Prepare meta createCustomConversion (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"action_source_type":{"type":"string","enum":["app","business_messaging","chat","email","other","phone_call","physical_store","system_generated","website"]},"advanced_rule":{"type":"string","maxLength":100000},"custom_event_type":{"type":"string","enum":["ADD_PAYMENT_INFO","ADD_TO_CART","ADD_TO_WISHLIST","COMPLETE_REGISTRATION","CONTACT","CONTENT_VIEW","CUSTOMIZE_PRODUCT","DONATE","FACEBOOK_SELECTED","FIND_LOCATION","INITIATED_CHECKOUT","LEAD","LISTING_INTERACTION","OTHER","PURCHASE","SCHEDULE","SEARCH","START_TRIAL","SUBMIT_APPLICATION","SUBSCRIBE"]},"default_conversion_value":{"type":"number"},"description":{"type":"string","maxLength":100000},"event_source_id":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000},"rule":{"type":"string","maxLength":100000}},"required":["custom_event_type","event_source_id","name","rule"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createCustomConversion"}},"/accounts/{accountId}/native/meta/createLabel":{"post":{"summary":"Prepare meta createLabel (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000}},"required":["name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createLabel"}},"/accounts/{accountId}/native/meta/createValueRuleSet":{"post":{"summary":"Prepare meta createValueRuleSet (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"entry_point":{"type":"string","enum":["ADVERTISING_SETTINGS","L2_AUDIENCE","L2_CONVERSION_LOCATION","L2_GLOBAL","L2_NCA_GOAL","L2_PLACEMENT"]},"name":{"type":"string","maxLength":100000},"product_type":{"type":"string","enum":["AUDIENCE","LEADGEN_ADS","OMNI_CHANNEL"]},"rules":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["name","rules"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createValueRuleSet"}},"/accounts/{accountId}/native/meta/getAudience":{"post":{"summary":"Read meta getAudience (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"special_ad_categories":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"special_ad_category_countries":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"target_countries":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getAudience"}},"/accounts/{accountId}/native/meta/updateAudience":{"post":{"summary":"Prepare meta updateAudience (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"allowed_domains":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"audience_labels":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["APP_USERS","AT_RISK","CART_ABANDONERS","DISENGAGED","DISQUALIFIED_LEADS","ENGAGED_USERS","GENERAL_CUSTOMERS","HIGH_VALUE_CUSTOMERS","LOW_VALUE_CUSTOMERS","OTHER_1","OTHER_2","OTHER_3","QUALIFIED_LEADS","RECENT_PURCHASERS","TRIAL_USERS"]}},"claim_objective":{"type":"string","enum":["AUTOMOTIVE_MODEL","COLLABORATIVE_ADS","HOME_LISTING","MEDIA_TITLE","PRODUCT","TRAVEL","VEHICLE","VEHICLE_OFFER"]},"content_type":{"type":"string","enum":["AUTOMOTIVE_MODEL","DESTINATION","FLIGHT","GENERIC","HOME_LISTING","HOTEL","LOCAL_SERVICE_BUSINESS","MEDIA_TITLE","OFFLINE_PRODUCT","PRODUCT","VEHICLE","VEHICLE_OFFER"]},"countries":{"type":"string","maxLength":100000},"customer_file_source":{"type":"string","enum":["BOTH_USER_AND_PARTNER_PROVIDED","PARTNER_PROVIDED_ONLY","USER_PROVIDED_ONLY"]},"description":{"type":"string","maxLength":100000},"enable_fetch_or_create":{"type":"boolean"},"event_source_group":{"type":"string","maxLength":100000},"event_sources":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"exclusions":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"inclusionOperator":{"type":"string","maxLength":100000},"inclusions":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"lookalike_spec":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000},"opt_out_link":{"type":"string","maxLength":100000},"parent_audience_id":{"type":"integer","minimum":0,"maximum":9007199254740991},"product_set_id":{"type":"string","maxLength":100000},"retention_days":{"type":"integer","minimum":0,"maximum":9007199254740991},"rev_share_policy_id":{"type":"integer","minimum":0,"maximum":9007199254740991},"rule":{"type":"string","maxLength":100000},"rule_aggregation":{"type":"string","maxLength":100000},"tags":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"use_for_products":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["ADS","MARKETING_MESSAGES"]}},"use_in_campaigns":{"type":"boolean"}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_updateAudience"}},"/accounts/{accountId}/native/meta/deleteAudience":{"post":{"summary":"Prepare meta deleteAudience (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_deleteAudience"}},"/accounts/{accountId}/native/meta/getCustomConversion":{"post":{"summary":"Read meta getCustomConversion (customConversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getCustomConversion"}},"/accounts/{accountId}/native/meta/updateCustomConversion":{"post":{"summary":"Prepare meta updateCustomConversion (customConversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"default_conversion_value":{"type":"number"},"description":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_updateCustomConversion"}},"/accounts/{accountId}/native/meta/deleteCustomConversion":{"post":{"summary":"Prepare meta deleteCustomConversion (customConversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_deleteCustomConversion"}},"/accounts/{accountId}/native/meta/getPixel":{"post":{"summary":"Read meta getPixel (pixel)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getPixel"}},"/accounts/{accountId}/native/meta/updatePixel":{"post":{"summary":"Prepare meta updatePixel (pixel)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"automatic_matching_fields":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["country","ct","db","em","external_id","fn","ge","ln","ph","st","zp"]}},"data_use_setting":{"type":"string","enum":["ADVERTISING_AND_ANALYTICS","ANALYTICS_ONLY","EMPTY"]},"enable_automatic_matching":{"type":"boolean"},"first_party_cookie_status":{"type":"string","enum":["EMPTY","FIRST_PARTY_COOKIE_DISABLED","FIRST_PARTY_COOKIE_ENABLED"]},"name":{"type":"string","maxLength":100000},"server_events_business_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"server_events_business_ids_add":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"server_events_business_ids_remove":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_updatePixel"}},"/accounts/{accountId}/native/meta/getValueRuleSet":{"post":{"summary":"Read meta getValueRuleSet (valueRuleSet)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getValueRuleSet"}},"/accounts/{accountId}/native/meta/updateValueRuleSet":{"post":{"summary":"Prepare meta updateValueRuleSet (valueRuleSet)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"entry_point":{"type":"string","enum":["ADVERTISING_SETTINGS","L2_AUDIENCE","L2_CONVERSION_LOCATION","L2_GLOBAL","L2_NCA_GOAL","L2_PLACEMENT"]},"is_default_setting":{"type":"boolean"},"name":{"type":"string","maxLength":100000},"rules":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_updateValueRuleSet"}},"/accounts/{accountId}/native/meta/addAudienceUsers":{"post":{"summary":"Prepare meta addAudienceUsers (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"namespace":{"type":"string","maxLength":100000},"payload":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"session":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["payload"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_addAudienceUsers"}},"/accounts/{accountId}/native/meta/removeAudienceUsers":{"post":{"summary":"Prepare meta removeAudienceUsers (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"namespace":{"type":"string","maxLength":100000},"payload":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"session":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["payload"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_removeAudienceUsers"}},"/accounts/{accountId}/native/meta/getPixelStats":{"post":{"summary":"Read meta getPixelStats (pixel)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"agent":{"type":"string","maxLength":100000},"aggregation":{"type":"string","maxLength":100000},"end_time":{"type":"string","maxLength":100000},"event":{"type":"string","maxLength":100000},"event_source":{"type":"string","maxLength":100000},"start_time":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getPixelStats"}},"/accounts/{accountId}/native/meta/getPixelSharedAccounts":{"post":{"summary":"Read meta getPixelSharedAccounts (pixel)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"business":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getPixelSharedAccounts"}},"/accounts/{accountId}/native/meta/sharePixel":{"post":{"summary":"Prepare meta sharePixel (pixel)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"account_id":{"type":"string","maxLength":100000},"business":{"type":"string","maxLength":100000}},"required":["account_id","business"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_sharePixel"}},"/accounts/{accountId}/native/meta/unsharePixel":{"post":{"summary":"Prepare meta unsharePixel (pixel)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"account_id":{"type":"string","maxLength":100000},"business":{"type":"string","maxLength":100000}},"required":["account_id","business"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_unsharePixel"}},"/accounts/{accountId}/native/meta/getCustomConversionStats":{"post":{"summary":"Read meta getCustomConversionStats (customConversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"aggregation":{"type":"string","maxLength":100000},"end_time":{"type":"string","maxLength":100000},"start_time":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getCustomConversionStats"}},"/accounts/{accountId}/native/meta/listLeadForms":{"post":{"summary":"Read meta listLeadForms (page)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listLeadForms"}},"/accounts/{accountId}/native/meta/createLeadForm":{"post":{"summary":"Prepare meta createLeadForm (page)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"allow_organic_lead_retrieval":{"type":"boolean"},"block_display_for_non_targeted_viewer":{"type":"boolean"},"context_card":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"cover_photo":{"type":"string","maxLength":100000},"custom_disclaimer":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"follow_up_action_url":{"type":"string","maxLength":100000},"is_for_canvas":{"type":"boolean"},"is_lead_capture_ai_agent_enabled":{"type":"boolean"},"is_optimized_for_quality":{"type":"boolean"},"is_phone_sms_verify_enabled":{"type":"boolean"},"locale":{"type":"string","enum":["AR_AR","CS_CZ","DA_DK","DE_DE","EL_GR","EN_GB","EN_US","ES_ES","ES_LA","FI_FI","FR_FR","HE_IL","HI_IN","HU_HU","ID_ID","IT_IT","JA_JP","KO_KR","NB_NO","NL_NL","PL_PL","PT_BR","PT_PT","RO_RO","RU_RU","SV_SE","TH_TH","TR_TR","VI_VN","ZH_CN","ZH_HK","ZH_TW"]},"name":{"type":"string","maxLength":100000},"privacy_policy":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"question_page_custom_headline":{"type":"string","maxLength":100000},"questions":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"should_enforce_work_email":{"type":"boolean"},"thank_you_page":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"tracking_parameters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"upload_gated_file":{"type":"string","maxLength":100000}},"required":["name","privacy_policy","questions"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createLeadForm"}},"/accounts/{accountId}/native/meta/getLeadForm":{"post":{"summary":"Read meta getLeadForm (leadForm)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"parentId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","parentId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getLeadForm"}},"/accounts/{accountId}/native/meta/updateLeadForm":{"post":{"summary":"Prepare meta updateLeadForm (leadForm)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"parentId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"status":{"type":"string","enum":["ACTIVE","ARCHIVED","DELETED","DRAFT"]}},"required":["status"],"additionalProperties":false}},"required":["entityId","parentId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_updateLeadForm"}},"/accounts/{accountId}/native/meta/listFormLeads":{"post":{"summary":"Read meta listFormLeads (leadForm)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"parentId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","parentId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listFormLeads"}},"/accounts/{accountId}/native/meta/listTestLeads":{"post":{"summary":"Read meta listTestLeads (leadForm)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"parentId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","parentId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listTestLeads"}},"/accounts/{accountId}/native/meta/createTestLead":{"post":{"summary":"Prepare meta createTestLead (leadForm)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"parentId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"custom_disclaimer_responses":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"field_data":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"additionalProperties":false}},"required":["entityId","parentId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createTestLead"}},"/accounts/{accountId}/native/meta/getAdPreviews":{"post":{"summary":"Read meta getAdPreviews (ad)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"ad_format":{"type":"string","enum":["AUDIENCE_NETWORK_INSTREAM_VIDEO","AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE","AUDIENCE_NETWORK_OUTSTREAM_VIDEO","AUDIENCE_NETWORK_REWARDED_VIDEO","BIZ_DISCO_FEED_MOBILE","DESKTOP_FEED_STANDARD","FACEBOOK_IFU_REELS_MOBILE","FACEBOOK_PROFILE_FEED_DESKTOP","FACEBOOK_PROFILE_FEED_MOBILE","FACEBOOK_PROFILE_REELS_MOBILE","FACEBOOK_REELS_BANNER","FACEBOOK_REELS_BANNER_DESKTOP","FACEBOOK_REELS_BANNER_FEED_ANDROID","FACEBOOK_REELS_BANNER_FEED_ANDROID_LARGE","FACEBOOK_REELS_BANNER_FULLSCREEN_IOS","FACEBOOK_REELS_BANNER_FULLSCREEN_MOBILE","FACEBOOK_REELS_MOBILE","FACEBOOK_REELS_POSTLOOP","FACEBOOK_REELS_POSTLOOP_FEED","FACEBOOK_REELS_SIMILAR_PRODUCTS_MOBILE","FACEBOOK_REELS_STICKER","FACEBOOK_STORY_MOBILE","FACEBOOK_STORY_STICKER_MOBILE","INSTAGRAM_EXPLORE_CONTEXTUAL","INSTAGRAM_EXPLORE_GRID_HOME","INSTAGRAM_EXPLORE_IMMERSIVE","INSTAGRAM_FEED_WEB","INSTAGRAM_FEED_WEB_M_SITE","INSTAGRAM_LEAD_GEN_MULTI_SUBMIT_ADS","INSTAGRAM_PROFILE_FEED","INSTAGRAM_PROFILE_REELS","INSTAGRAM_REELS","INSTAGRAM_REELS_OVERLAY","INSTAGRAM_REELS_WEB","INSTAGRAM_REELS_WEB_M_SITE","INSTAGRAM_SEARCH_CHAIN","INSTAGRAM_SEARCH_GRID","INSTAGRAM_STANDARD","INSTAGRAM_STORY","INSTAGRAM_STORY_EFFECT_TRAY","INSTAGRAM_STORY_WEB","INSTAGRAM_STORY_WEB_M_SITE","INSTANT_ARTICLE_RECIRCULATION_AD","INSTANT_ARTICLE_STANDARD","INSTREAM_BANNER_DESKTOP","INSTREAM_BANNER_FEED_IOS","INSTREAM_BANNER_FULLSCREEN_IOS","INSTREAM_BANNER_FULLSCREEN_MOBILE","INSTREAM_BANNER_IMMERSIVE_MOBILE","INSTREAM_BANNER_MOBILE","INSTREAM_VIDEO_DESKTOP","INSTREAM_VIDEO_FULLSCREEN_IOS","INSTREAM_VIDEO_FULLSCREEN_MOBILE","INSTREAM_VIDEO_IMAGE","INSTREAM_VIDEO_IMMERSIVE_MOBILE","INSTREAM_VIDEO_MOBILE","JOB_BROWSER_DESKTOP","JOB_BROWSER_MOBILE","MARKETPLACE_MOBILE","MESSENGER_MOBILE_INBOX_MEDIA","MESSENGER_MOBILE_STORY_MEDIA","MOBILE_BANNER","MOBILE_FEED_BASIC","MOBILE_FEED_STANDARD","MOBILE_FULLWIDTH","MOBILE_INTERSTITIAL","MOBILE_MEDIUM_RECTANGLE","MOBILE_NATIVE","RIGHT_COLUMN_STANDARD","SUGGESTED_VIDEO_DESKTOP","SUGGESTED_VIDEO_FULLSCREEN_MOBILE","SUGGESTED_VIDEO_IMMERSIVE_MOBILE","SUGGESTED_VIDEO_MOBILE","WATCH_FEED_HOME","WATCH_FEED_MOBILE","WHATSAPP_STATUS_MEDIA"]},"creative_feature":{"type":"string","enum":["ig_video_native_subtitle","image_animation","product_browsing","product_metadata_automation","profile_card","standard_enhancements_catalog","text_overlay_translation"]},"dynamic_asset_label":{"type":"string","maxLength":100000},"dynamic_creative_spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"dynamic_customization":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"end_date":{"type":"string","maxLength":100000},"height":{"type":"integer","minimum":0,"maximum":9007199254740991},"locale":{"type":"string","maxLength":100000},"post":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"product_item_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"render_type":{"type":"string","enum":["FALLBACK"]},"start_date":{"type":"string","maxLength":100000},"width":{"type":"integer","minimum":0,"maximum":9007199254740991},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getAdPreviews"}},"/accounts/{accountId}/native/meta/listAdLeads":{"post":{"summary":"Read meta listAdLeads (ad)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listAdLeads"}},"/accounts/{accountId}/native/meta/listBudgetSchedulesCampaign":{"post":{"summary":"Read meta listBudgetSchedulesCampaign (campaign)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"time_start":{"type":"string","maxLength":100000},"time_stop":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listBudgetSchedulesCampaign"}},"/accounts/{accountId}/native/meta/createBudgetScheduleCampaign":{"post":{"summary":"Prepare meta createBudgetScheduleCampaign (campaign)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"budget_value":{"type":"integer","minimum":0,"maximum":9007199254740991},"budget_value_type":{"type":"string","maxLength":100000},"time_end":{"type":"integer","minimum":0,"maximum":9007199254740991},"time_start":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createBudgetScheduleCampaign"}},"/accounts/{accountId}/native/meta/listBudgetSchedulesAdgroup":{"post":{"summary":"Read meta listBudgetSchedulesAdgroup (adGroup)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"time_start":{"type":"string","maxLength":100000},"time_stop":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listBudgetSchedulesAdgroup"}},"/accounts/{accountId}/native/meta/createBudgetScheduleAdgroup":{"post":{"summary":"Prepare meta createBudgetScheduleAdgroup (adGroup)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"budget_value":{"type":"integer","minimum":0,"maximum":9007199254740991},"budget_value_type":{"type":"string","maxLength":100000},"time_end":{"type":"integer","minimum":0,"maximum":9007199254740991},"time_start":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createBudgetScheduleAdgroup"}},"/accounts/{accountId}/native/meta/listCatalogs":{"post":{"summary":"Read meta listCatalogs (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listCatalogs"}},"/accounts/{accountId}/native/meta/createCatalog":{"post":{"summary":"Prepare meta createCatalog (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"vertical":{"type":"string","enum":["commerce","hotels","flights","destinations","home_listings","vehicles","local_service_businesses"]}},"required":["name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createCatalog"}},"/accounts/{accountId}/native/meta/listProductSets":{"post":{"summary":"Read meta listProductSets (catalog)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listProductSets"}},"/accounts/{accountId}/native/meta/createProductSet":{"post":{"summary":"Prepare meta createProductSet (catalog)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"filter":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["name"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createProductSet"}},"/accounts/{accountId}/native/meta/listProductFeeds":{"post":{"summary":"Read meta listProductFeeds (catalog)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listProductFeeds"}},"/accounts/{accountId}/native/meta/createProductFeed":{"post":{"summary":"Prepare meta createProductFeed (catalog)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"schedule":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"default_currency":{"type":"string","maxLength":100000}},"required":["name"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createProductFeed"}},"/accounts/{accountId}/native/meta/applyRecommendation":{"post":{"summary":"Prepare meta applyRecommendation (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"recommendation_signature":{"type":"string","maxLength":100000},"extra_data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["recommendation_signature"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_applyRecommendation"}},"/accounts/{accountId}/native/meta/queryInsights":{"post":{"summary":"Read meta queryInsights (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"action_attribution_windows":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["1d_click","1d_ev","1d_sequenced","1d_view","28d_click","28d_sequenced","28d_view","28d_view_all_conversions","28d_view_first_conversion","7d_click","7d_sequenced","7d_view","7d_view_all_conversions","7d_view_first_conversion","custom","dda","default","incrementality","incrementality_all_conversions","incrementality_first_conversion","skan_click","skan_click_second_postback","skan_click_third_postback","skan_view","skan_view_second_postback","skan_view_third_postback"]}},"action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"action_report_time":{"type":"string","enum":["conversion","impression","lifetime","mixed"]},"breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["ad_extension_domain","ad_extension_url","ad_format_asset","affiliate_click_region","affiliate_link_url","age","app_id","body_asset","breakdown_ad_objective","breakdown_reporting_ad_id","call_to_action_asset","coarse_conversion_value","comscore_market","conversion_destination","country","creative_automation_asset_id","creative_relaxation_asset_type","crm_advertiser_l12_territory_ids","crm_advertiser_subvertical_id","crm_advertiser_vertical_id","crm_ult_advertiser_id","description_asset","device_platform","dma","existing_post_id","fidelity_type","flexible_format_asset_type","frequency_value","gen_ai_asset_type","gender","hourly_stats_aggregated_by_advertiser_time_zone","hourly_stats_aggregated_by_audience_time_zone","hsid","image_asset","impression_device","impression_view_time_advertiser_hour_v2","instagram_ads_follow_type","instagram_ads_instagram_media_product_type","instagram_ads_time_since_creation_bucket","internal_campaign_id","is_auto_advance","is_conversion_id_modeled","is_rendered_as_delayed_skip_ad","landing_destination","link_url_asset","marketing_messages_btn_name","mdsa_landing_destination","media_asset_url","media_creator","media_destination_url","media_format","media_origin_url","media_text_content","media_type","mmm","msa_seller_name","overlap_segment","pa_creator_ig_handle","place_page_id","placement_path","platform_position","postback_sequence_index","product_brand_breakdown","product_category_breakdown","product_custom_label_0_breakdown","product_custom_label_1_breakdown","product_custom_label_2_breakdown","product_custom_label_3_breakdown","product_custom_label_4_breakdown","product_group_content_id_breakdown","product_id","publisher_platform","redownload","reels_trending_topic","region","rta_ugc_topic","rule_set_id","rule_set_name","signal_source_bucket","skan_campaign_id","skan_conversion_id","skan_version","sot_attribution_model_type","sot_attribution_window","sot_channel","sot_event_type","sot_source","standard_event_content_type","title_asset","user_persona_id","user_persona_name","video_asset","zip"]}},"date_preset":{"type":"string","enum":["data_maximum","last_14d","last_28d","last_30d","last_3d","last_7d","last_90d","last_month","last_quarter","last_week_mon_sun","last_week_sun_sat","last_year","maximum","this_month","this_quarter","this_week_mon_today","this_week_sun_today","this_year","today","yesterday"]},"default_summary":{"type":"boolean"},"export_columns":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"export_format":{"type":"string","maxLength":100000},"export_name":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"filtering":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"graph_cache":{"type":"boolean"},"level":{"type":"string","enum":["account","ad","adset","campaign"]},"limit":{"type":"integer","minimum":1,"maximum":1000},"product_id_limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sort":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary_action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"time_increment":{"type":"string","maxLength":100000},"time_range":{"type":"object","properties":{"since":{"type":"string","format":"date","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])))$"},"until":{"type":"string","format":"date","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])))$"}},"required":["since","until"],"additionalProperties":false},"time_ranges":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"use_account_attribution_setting":{"type":"boolean"},"use_unified_attribution_setting":{"type":"boolean"},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_queryInsights"}},"/accounts/{accountId}/native/meta/createInsightsReport":{"post":{"summary":"Prepare meta createInsightsReport (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"action_attribution_windows":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["1d_click","1d_ev","1d_sequenced","1d_view","28d_click","28d_sequenced","28d_view","28d_view_all_conversions","28d_view_first_conversion","7d_click","7d_sequenced","7d_view","7d_view_all_conversions","7d_view_first_conversion","custom","dda","default","incrementality","incrementality_all_conversions","incrementality_first_conversion","skan_click","skan_click_second_postback","skan_click_third_postback","skan_view","skan_view_second_postback","skan_view_third_postback"]}},"action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"action_report_time":{"type":"string","enum":["conversion","impression","lifetime","mixed"]},"breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["ad_extension_domain","ad_extension_url","ad_format_asset","affiliate_click_region","affiliate_link_url","age","app_id","body_asset","breakdown_ad_objective","breakdown_reporting_ad_id","call_to_action_asset","coarse_conversion_value","comscore_market","conversion_destination","country","creative_automation_asset_id","creative_relaxation_asset_type","crm_advertiser_l12_territory_ids","crm_advertiser_subvertical_id","crm_advertiser_vertical_id","crm_ult_advertiser_id","description_asset","device_platform","dma","existing_post_id","fidelity_type","flexible_format_asset_type","frequency_value","gen_ai_asset_type","gender","hourly_stats_aggregated_by_advertiser_time_zone","hourly_stats_aggregated_by_audience_time_zone","hsid","image_asset","impression_device","impression_view_time_advertiser_hour_v2","instagram_ads_follow_type","instagram_ads_instagram_media_product_type","instagram_ads_time_since_creation_bucket","internal_campaign_id","is_auto_advance","is_conversion_id_modeled","is_rendered_as_delayed_skip_ad","landing_destination","link_url_asset","marketing_messages_btn_name","mdsa_landing_destination","media_asset_url","media_creator","media_destination_url","media_format","media_origin_url","media_text_content","media_type","mmm","msa_seller_name","overlap_segment","pa_creator_ig_handle","place_page_id","placement_path","platform_position","postback_sequence_index","product_brand_breakdown","product_category_breakdown","product_custom_label_0_breakdown","product_custom_label_1_breakdown","product_custom_label_2_breakdown","product_custom_label_3_breakdown","product_custom_label_4_breakdown","product_group_content_id_breakdown","product_id","publisher_platform","redownload","reels_trending_topic","region","rta_ugc_topic","rule_set_id","rule_set_name","signal_source_bucket","skan_campaign_id","skan_conversion_id","skan_version","sot_attribution_model_type","sot_attribution_window","sot_channel","sot_event_type","sot_source","standard_event_content_type","title_asset","user_persona_id","user_persona_name","video_asset","zip"]}},"date_preset":{"type":"string","enum":["data_maximum","last_14d","last_28d","last_30d","last_3d","last_7d","last_90d","last_month","last_quarter","last_week_mon_sun","last_week_sun_sat","last_year","maximum","this_month","this_quarter","this_week_mon_today","this_week_sun_today","this_year","today","yesterday"]},"default_summary":{"type":"boolean"},"export_columns":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"export_format":{"type":"string","maxLength":100000},"export_name":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"filtering":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"graph_cache":{"type":"boolean"},"level":{"type":"string","enum":["account","ad","adset","campaign"]},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"product_id_limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sort":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary_action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"time_increment":{"type":"string","maxLength":100000},"time_range":{"type":"object","properties":{"since":{"type":"string","format":"date","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])))$"},"until":{"type":"string","format":"date","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])))$"}},"required":["since","until"],"additionalProperties":false},"time_ranges":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"use_account_attribution_setting":{"type":"boolean"},"use_unified_attribution_setting":{"type":"boolean"}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createInsightsReport"}},"/accounts/{accountId}/native/meta/queryCampaignInsights":{"post":{"summary":"Read meta queryCampaignInsights (campaign)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"action_attribution_windows":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["1d_click","1d_ev","1d_sequenced","1d_view","28d_click","28d_sequenced","28d_view","28d_view_all_conversions","28d_view_first_conversion","7d_click","7d_sequenced","7d_view","7d_view_all_conversions","7d_view_first_conversion","custom","dda","default","incrementality","incrementality_all_conversions","incrementality_first_conversion","skan_click","skan_click_second_postback","skan_click_third_postback","skan_view","skan_view_second_postback","skan_view_third_postback"]}},"action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"action_report_time":{"type":"string","enum":["conversion","impression","lifetime","mixed"]},"breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["ad_extension_domain","ad_extension_url","ad_format_asset","affiliate_click_region","affiliate_link_url","age","app_id","body_asset","breakdown_ad_objective","breakdown_reporting_ad_id","call_to_action_asset","coarse_conversion_value","comscore_market","conversion_destination","country","creative_automation_asset_id","creative_relaxation_asset_type","crm_advertiser_l12_territory_ids","crm_advertiser_subvertical_id","crm_advertiser_vertical_id","crm_ult_advertiser_id","description_asset","device_platform","dma","existing_post_id","fidelity_type","flexible_format_asset_type","frequency_value","gen_ai_asset_type","gender","hourly_stats_aggregated_by_advertiser_time_zone","hourly_stats_aggregated_by_audience_time_zone","hsid","image_asset","impression_device","impression_view_time_advertiser_hour_v2","instagram_ads_follow_type","instagram_ads_instagram_media_product_type","instagram_ads_time_since_creation_bucket","internal_campaign_id","is_auto_advance","is_conversion_id_modeled","is_rendered_as_delayed_skip_ad","landing_destination","link_url_asset","marketing_messages_btn_name","mdsa_landing_destination","media_asset_url","media_creator","media_destination_url","media_format","media_origin_url","media_text_content","media_type","mmm","msa_seller_name","overlap_segment","pa_creator_ig_handle","place_page_id","placement_path","platform_position","postback_sequence_index","product_brand_breakdown","product_category_breakdown","product_custom_label_0_breakdown","product_custom_label_1_breakdown","product_custom_label_2_breakdown","product_custom_label_3_breakdown","product_custom_label_4_breakdown","product_group_content_id_breakdown","product_id","publisher_platform","redownload","reels_trending_topic","region","rta_ugc_topic","rule_set_id","rule_set_name","signal_source_bucket","skan_campaign_id","skan_conversion_id","skan_version","sot_attribution_model_type","sot_attribution_window","sot_channel","sot_event_type","sot_source","standard_event_content_type","title_asset","user_persona_id","user_persona_name","video_asset","zip"]}},"date_preset":{"type":"string","enum":["data_maximum","last_14d","last_28d","last_30d","last_3d","last_7d","last_90d","last_month","last_quarter","last_week_mon_sun","last_week_sun_sat","last_year","maximum","this_month","this_quarter","this_week_mon_today","this_week_sun_today","this_year","today","yesterday"]},"default_summary":{"type":"boolean"},"export_columns":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"export_format":{"type":"string","maxLength":100000},"export_name":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"filtering":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"graph_cache":{"type":"boolean"},"level":{"type":"string","enum":["account","ad","adset","campaign"]},"limit":{"type":"integer","minimum":1,"maximum":1000},"product_id_limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sort":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary_action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"time_increment":{"type":"string","maxLength":100000},"time_range":{"type":"object","properties":{"since":{"type":"string","format":"date","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])))$"},"until":{"type":"string","format":"date","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])))$"}},"required":["since","until"],"additionalProperties":false},"time_ranges":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"use_account_attribution_setting":{"type":"boolean"},"use_unified_attribution_setting":{"type":"boolean"},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_queryCampaignInsights"}},"/accounts/{accountId}/native/meta/queryAdSetInsights":{"post":{"summary":"Read meta queryAdSetInsights (adGroup)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"action_attribution_windows":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["1d_click","1d_ev","1d_sequenced","1d_view","28d_click","28d_sequenced","28d_view","28d_view_all_conversions","28d_view_first_conversion","7d_click","7d_sequenced","7d_view","7d_view_all_conversions","7d_view_first_conversion","custom","dda","default","incrementality","incrementality_all_conversions","incrementality_first_conversion","skan_click","skan_click_second_postback","skan_click_third_postback","skan_view","skan_view_second_postback","skan_view_third_postback"]}},"action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"action_report_time":{"type":"string","enum":["conversion","impression","lifetime","mixed"]},"breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["ad_extension_domain","ad_extension_url","ad_format_asset","affiliate_click_region","affiliate_link_url","age","app_id","body_asset","breakdown_ad_objective","breakdown_reporting_ad_id","call_to_action_asset","coarse_conversion_value","comscore_market","conversion_destination","country","creative_automation_asset_id","creative_relaxation_asset_type","crm_advertiser_l12_territory_ids","crm_advertiser_subvertical_id","crm_advertiser_vertical_id","crm_ult_advertiser_id","description_asset","device_platform","dma","existing_post_id","fidelity_type","flexible_format_asset_type","frequency_value","gen_ai_asset_type","gender","hourly_stats_aggregated_by_advertiser_time_zone","hourly_stats_aggregated_by_audience_time_zone","hsid","image_asset","impression_device","impression_view_time_advertiser_hour_v2","instagram_ads_follow_type","instagram_ads_instagram_media_product_type","instagram_ads_time_since_creation_bucket","internal_campaign_id","is_auto_advance","is_conversion_id_modeled","is_rendered_as_delayed_skip_ad","landing_destination","link_url_asset","marketing_messages_btn_name","mdsa_landing_destination","media_asset_url","media_creator","media_destination_url","media_format","media_origin_url","media_text_content","media_type","mmm","msa_seller_name","overlap_segment","pa_creator_ig_handle","place_page_id","placement_path","platform_position","postback_sequence_index","product_brand_breakdown","product_category_breakdown","product_custom_label_0_breakdown","product_custom_label_1_breakdown","product_custom_label_2_breakdown","product_custom_label_3_breakdown","product_custom_label_4_breakdown","product_group_content_id_breakdown","product_id","publisher_platform","redownload","reels_trending_topic","region","rta_ugc_topic","rule_set_id","rule_set_name","signal_source_bucket","skan_campaign_id","skan_conversion_id","skan_version","sot_attribution_model_type","sot_attribution_window","sot_channel","sot_event_type","sot_source","standard_event_content_type","title_asset","user_persona_id","user_persona_name","video_asset","zip"]}},"date_preset":{"type":"string","enum":["data_maximum","last_14d","last_28d","last_30d","last_3d","last_7d","last_90d","last_month","last_quarter","last_week_mon_sun","last_week_sun_sat","last_year","maximum","this_month","this_quarter","this_week_mon_today","this_week_sun_today","this_year","today","yesterday"]},"default_summary":{"type":"boolean"},"export_columns":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"export_format":{"type":"string","maxLength":100000},"export_name":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"filtering":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"graph_cache":{"type":"boolean"},"level":{"type":"string","enum":["account","ad","adset","campaign"]},"limit":{"type":"integer","minimum":1,"maximum":1000},"product_id_limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sort":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary_action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"time_increment":{"type":"string","maxLength":100000},"time_range":{"type":"object","properties":{"since":{"type":"string","format":"date","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])))$"},"until":{"type":"string","format":"date","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])))$"}},"required":["since","until"],"additionalProperties":false},"time_ranges":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"use_account_attribution_setting":{"type":"boolean"},"use_unified_attribution_setting":{"type":"boolean"},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_queryAdSetInsights"}},"/accounts/{accountId}/native/meta/queryAdInsights":{"post":{"summary":"Read meta queryAdInsights (ad)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"action_attribution_windows":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["1d_click","1d_ev","1d_sequenced","1d_view","28d_click","28d_sequenced","28d_view","28d_view_all_conversions","28d_view_first_conversion","7d_click","7d_sequenced","7d_view","7d_view_all_conversions","7d_view_first_conversion","custom","dda","default","incrementality","incrementality_all_conversions","incrementality_first_conversion","skan_click","skan_click_second_postback","skan_click_third_postback","skan_view","skan_view_second_postback","skan_view_third_postback"]}},"action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"action_report_time":{"type":"string","enum":["conversion","impression","lifetime","mixed"]},"breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["ad_extension_domain","ad_extension_url","ad_format_asset","affiliate_click_region","affiliate_link_url","age","app_id","body_asset","breakdown_ad_objective","breakdown_reporting_ad_id","call_to_action_asset","coarse_conversion_value","comscore_market","conversion_destination","country","creative_automation_asset_id","creative_relaxation_asset_type","crm_advertiser_l12_territory_ids","crm_advertiser_subvertical_id","crm_advertiser_vertical_id","crm_ult_advertiser_id","description_asset","device_platform","dma","existing_post_id","fidelity_type","flexible_format_asset_type","frequency_value","gen_ai_asset_type","gender","hourly_stats_aggregated_by_advertiser_time_zone","hourly_stats_aggregated_by_audience_time_zone","hsid","image_asset","impression_device","impression_view_time_advertiser_hour_v2","instagram_ads_follow_type","instagram_ads_instagram_media_product_type","instagram_ads_time_since_creation_bucket","internal_campaign_id","is_auto_advance","is_conversion_id_modeled","is_rendered_as_delayed_skip_ad","landing_destination","link_url_asset","marketing_messages_btn_name","mdsa_landing_destination","media_asset_url","media_creator","media_destination_url","media_format","media_origin_url","media_text_content","media_type","mmm","msa_seller_name","overlap_segment","pa_creator_ig_handle","place_page_id","placement_path","platform_position","postback_sequence_index","product_brand_breakdown","product_category_breakdown","product_custom_label_0_breakdown","product_custom_label_1_breakdown","product_custom_label_2_breakdown","product_custom_label_3_breakdown","product_custom_label_4_breakdown","product_group_content_id_breakdown","product_id","publisher_platform","redownload","reels_trending_topic","region","rta_ugc_topic","rule_set_id","rule_set_name","signal_source_bucket","skan_campaign_id","skan_conversion_id","skan_version","sot_attribution_model_type","sot_attribution_window","sot_channel","sot_event_type","sot_source","standard_event_content_type","title_asset","user_persona_id","user_persona_name","video_asset","zip"]}},"date_preset":{"type":"string","enum":["data_maximum","last_14d","last_28d","last_30d","last_3d","last_7d","last_90d","last_month","last_quarter","last_week_mon_sun","last_week_sun_sat","last_year","maximum","this_month","this_quarter","this_week_mon_today","this_week_sun_today","this_year","today","yesterday"]},"default_summary":{"type":"boolean"},"export_columns":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"export_format":{"type":"string","maxLength":100000},"export_name":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"filtering":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"graph_cache":{"type":"boolean"},"level":{"type":"string","enum":["account","ad","adset","campaign"]},"limit":{"type":"integer","minimum":1,"maximum":1000},"product_id_limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sort":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"summary_action_breakdowns":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["action_canvas_component_name","action_carousel_card_id","action_carousel_card_name","action_destination","action_device","action_reaction","action_target_id","action_type","action_video_sound","action_video_type","conversion_destination","is_business_ai_assisted","matched_persona_id","matched_persona_name","signal_source_bucket","standard_event_content_type"]}},"time_increment":{"type":"string","maxLength":100000},"time_range":{"type":"object","properties":{"since":{"type":"string","format":"date","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])))$"},"until":{"type":"string","format":"date","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])))$"}},"required":["since","until"],"additionalProperties":false},"time_ranges":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"use_account_attribution_setting":{"type":"boolean"},"use_unified_attribution_setting":{"type":"boolean"},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_queryAdInsights"}},"/accounts/{accountId}/native/meta/listStudies":{"post":{"summary":"Read meta listStudies (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listStudies"}},"/accounts/{accountId}/native/meta/listReachFrequencyPredictions":{"post":{"summary":"Read meta listReachFrequencyPredictions (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listReachFrequencyPredictions"}},"/accounts/{accountId}/native/meta/createReachFrequencyPrediction":{"post":{"summary":"Prepare meta createReachFrequencyPrediction (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"action":{"type":"string","enum":["cancel","quote","reserve"]},"ad_formats":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"auction_entry_option_index":{"type":"integer","minimum":0,"maximum":9007199254740991},"budget":{"type":"integer","minimum":0,"maximum":9007199254740991},"buying_type":{"type":"string","enum":["AUCTION","DEPRECATED_REACH_BLOCK","FIXED_CPM","MIXED","REACHBLOCK","RESEARCH_POLL","RESERVED"]},"campaign_group_id":{"type":"string","maxLength":100000},"day_parting_schedule":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"deal_id":{"type":"string","maxLength":100000},"destination_id":{"type":"integer","minimum":0,"maximum":9007199254740991},"destination_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"end_time":{"type":"integer","minimum":0,"maximum":9007199254740991},"exceptions":{"type":"boolean"},"existing_campaign_id":{"type":"string","maxLength":100000},"expiration_time":{"type":"integer","minimum":0,"maximum":9007199254740991},"frequency_cap":{"type":"integer","minimum":0,"maximum":9007199254740991},"grp_buying":{"type":"boolean"},"impression":{"type":"integer","minimum":0,"maximum":9007199254740991},"instream_packages":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["BEAUTY","ENTERTAINMENT","FOOD","NORMAL","PREMIUM","REGULAR_ANIMALS_PETS","REGULAR_FOOD","REGULAR_GAMES","REGULAR_POLITICS","REGULAR_SPORTS","REGULAR_STYLE","REGULAR_TV_MOVIES","SPANISH","SPORTS"]}},"interval_frequency_cap_reset_period":{"type":"integer","minimum":0,"maximum":9007199254740991},"is_balanced_frequency":{"type":"boolean"},"is_bonus_media":{"type":"boolean"},"is_conversion_goal":{"type":"boolean"},"is_full_view":{"type":"boolean"},"is_higher_average_frequency":{"type":"boolean"},"is_reach_and_frequency_io_buying":{"type":"boolean"},"is_reserved_buying":{"type":"boolean"},"meta_moment_maker_spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"num_curve_points":{"type":"integer","minimum":0,"maximum":9007199254740991},"objective":{"type":"string","maxLength":100000},"optimization_goal":{"type":"string","maxLength":100000},"prediction_mode":{"type":"integer","minimum":0,"maximum":9007199254740991},"reach":{"type":"integer","minimum":0,"maximum":9007199254740991},"rf_prediction_id":{"type":"string","maxLength":100000},"rf_prediction_id_to_release":{"type":"string","maxLength":100000},"rf_prediction_id_to_share":{"type":"string","maxLength":100000},"start_time":{"type":"integer","minimum":0,"maximum":9007199254740991},"stop_time":{"type":"integer","minimum":0,"maximum":9007199254740991},"story_event_type":{"type":"integer","minimum":0,"maximum":9007199254740991},"target_cpm":{"type":"integer","minimum":0,"maximum":9007199254740991},"target_frequency":{"type":"integer","minimum":0,"maximum":9007199254740991},"target_frequency_reset_period":{"type":"integer","minimum":0,"maximum":9007199254740991},"target_spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"trending_topics_spec":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"video_view_length_constraint":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["end_time","start_time","target_spec"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_createReachFrequencyPrediction"}},"/accounts/{accountId}/native/meta/getReachFrequencyPrediction":{"post":{"summary":"Read meta getReachFrequencyPrediction (prediction)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getReachFrequencyPrediction"}},"/accounts/{accountId}/native/meta/listCampaignBudgetSchedules":{"post":{"summary":"Read meta listCampaignBudgetSchedules (campaign)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"time_start":{"type":"string","maxLength":100000},"time_stop":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listCampaignBudgetSchedules"}},"/accounts/{accountId}/native/meta/listAdSetBudgetSchedules":{"post":{"summary":"Read meta listAdSetBudgetSchedules (adGroup)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"time_start":{"type":"string","maxLength":100000},"time_stop":{"type":"string","maxLength":100000},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listAdSetBudgetSchedules"}},"/accounts/{accountId}/native/meta/getInsightsReport":{"post":{"summary":"Read meta getInsightsReport (report)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"required":["operationId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getInsightsReport"}},"/accounts/{accountId}/native/meta/getInsightsReportRows":{"post":{"summary":"Read meta getInsightsReportRows (report)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"required":["operationId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getInsightsReportRows"}},"/accounts/{accountId}/native/meta/getAccountFinance":{"post":{"summary":"Read meta getAccountFinance (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getAccountFinance"}},"/accounts/{accountId}/native/meta/getDsaDefaults":{"post":{"summary":"Read meta getDsaDefaults (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getDsaDefaults"}},"/accounts/{accountId}/native/meta/updateDsaDefaults":{"post":{"summary":"Prepare meta updateDsaDefaults (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"default_dsa_beneficiary":{"type":"string","maxLength":100000},"default_dsa_payor":{"type":"string","maxLength":100000}},"required":["default_dsa_beneficiary","default_dsa_payor"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_updateDsaDefaults"}},"/accounts/{accountId}/native/meta/sendConversionEvents":{"post":{"summary":"Prepare meta sendConversionEvents (pixel)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"data":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"event_name":{"type":"string","minLength":1,"maxLength":100},"event_time":{"type":"integer","minimum":0,"maximum":9007199254740991},"event_id":{"type":"string","minLength":1,"maxLength":255},"action_source":{"type":"string","enum":["email","website","app","phone_call","chat","physical_store","system_generated","business_messaging","other"]},"event_source_url":{"type":"string","format":"uri"},"user_data":{"type":"object","properties":{"em":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"ph":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"fn":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"ln":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"ge":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"db":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"ct":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"st":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"zp":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"country":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"external_id":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-f0-9]{64}$"}}]},"client_ip_address":{"type":"string","maxLength":100},"client_user_agent":{"type":"string","maxLength":2000},"fbc":{"type":"string","maxLength":1000},"fbp":{"type":"string","maxLength":1000},"subscription_id":{"type":"string","maxLength":255},"fb_login_id":{"type":"string","maxLength":100},"lead_id":{"type":"string","maxLength":100},"page_id":{"type":"string","pattern":"^\\d+$"},"page_scoped_user_id":{"type":"string","maxLength":100},"ctwa_clid":{"type":"string","maxLength":1000},"madid":{"type":"string","maxLength":100}},"additionalProperties":false},"custom_data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"opt_out":{"type":"boolean"},"data_processing_options":{"maxItems":1,"type":"array","items":{"type":"string","enum":["LDU"]}},"data_processing_options_country":{"type":"integer","minimum":0,"maximum":9007199254740991},"data_processing_options_state":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["event_name","event_time","action_source","user_data"],"additionalProperties":false}},"test_event_code":{"type":"string","maxLength":100000},"partner_agent":{"type":"string","maxLength":100000}},"required":["data"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_sendConversionEvents"}},"/accounts/{accountId}/native/meta/startVideoUpload":{"post":{"summary":"Prepare meta startVideoUpload (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"file_size":{"type":"integer","minimum":1,"maximum":4294967296}},"required":["file_size"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_startVideoUpload"}},"/accounts/{accountId}/native/meta/transferVideoChunk":{"post":{"summary":"Prepare meta transferVideoChunk (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"file_base64":{"type":"string","minLength":4,"maxLength":27962028,"pattern":"^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"}},"required":["operationId","file_base64"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_transferVideoChunk"}},"/accounts/{accountId}/native/meta/finishVideoUpload":{"post":{"summary":"Prepare meta finishVideoUpload (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","maxLength":100000},"description":{"type":"string","maxLength":100000}},"required":["operationId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_finishVideoUpload"}},"/accounts/{accountId}/native/meta/getVideoStatus":{"post":{"summary":"Read meta getVideoStatus (video)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_getVideoStatus"}},"/accounts/{accountId}/native/meta/listVideos":{"post":{"summary":"Read meta listVideos (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"fields":{"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"}},"limit":{"type":"integer","minimum":1,"maximum":1000},"after":{"type":"string","maxLength":3000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_meta_listVideos"}},"/accounts/{accountId}/native/meta/deleteVideo":{"post":{"summary":"Prepare meta deleteVideo (video)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_meta_deleteVideo"}},"/accounts/{accountId}/native/google/generateKeywordIdeas":{"post":{"summary":"Read google generateKeywordIdeas (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"language":{"type":"string","maxLength":100000},"geoTargetConstants":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"keywordPlanNetwork":{"type":"string","maxLength":100000},"includeAdultKeywords":{"type":"boolean"},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageToken":{"type":"string","maxLength":100000},"keywordSeed":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"urlSeed":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"keywordAndUrlSeed":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"siteSeed":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"keywordAnnotation":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"aggregateMetrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"historicalMetricsOptions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_generateKeywordIdeas"}},"/accounts/{accountId}/native/google/generateKeywordHistoricalMetrics":{"post":{"summary":"Read google generateKeywordHistoricalMetrics (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"keywords":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"language":{"type":"string","maxLength":100000},"geoTargetConstants":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"keywordPlanNetwork":{"type":"string","maxLength":100000},"includeAdultKeywords":{"type":"boolean"},"historicalMetricsOptions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"aggregateMetrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["keywords"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_generateKeywordHistoricalMetrics"}},"/accounts/{accountId}/native/google/getSearchTerms":{"post":{"summary":"Read google getSearchTerms (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"},"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"adGroupId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["startDate","endDate"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_getSearchTerms"}},"/accounts/{accountId}/native/google/listLocalServicesLeads":{"post":{"summary":"Read google listLocalServicesLeads (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["startDate","endDate"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_listLocalServicesLeads"}},"/accounts/{accountId}/native/google/listLocalServicesLeadConversations":{"post":{"summary":"Read google listLocalServicesLeadConversations (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"leadId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["leadId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_listLocalServicesLeadConversations"}},"/accounts/{accountId}/native/google/ingestConversions":{"post":{"summary":"Prepare google ingestConversions (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"destinationId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"events":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"adIdentifiers":{"type":"object","properties":{"impressionId":{"type":"string","maxLength":100000},"gclid":{"type":"string","maxLength":100000},"gbraid":{"type":"string","maxLength":100000},"landingPageDeviceInfo":{"type":"object","properties":{"languageCode":{"type":"string","maxLength":100000},"operatingSystem":{"type":"string","maxLength":100000},"brand":{"type":"string","maxLength":100000},"ipAddress":{"type":"string","maxLength":100000},"screenWidth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"model":{"type":"string","maxLength":100000},"userAgent":{"type":"string","maxLength":100000},"operatingSystemVersion":{"type":"string","maxLength":100000},"browser":{"type":"string","maxLength":100000},"category":{"type":"string","maxLength":100000},"screenHeight":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"browserVersion":{"type":"string","maxLength":100000}},"additionalProperties":false},"wbraid":{"type":"string","maxLength":100000},"matchId":{"type":"string","maxLength":100000},"mobileDeviceId":{"type":"string","maxLength":100000},"encryptedUserIds":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"entityId":{"type":"string","maxLength":100000},"encryptedId":{"type":"string","maxLength":100000},"source":{"type":"string","enum":["ENCRYPTION_SOURCE_UNSPECIFIED","AD_SERVING","DATA_TRANSFER"]},"entityType":{"type":"string","enum":["ENCRYPTION_ENTITY_TYPE_UNSPECIFIED","CAMPAIGN_MANAGER_ACCOUNT","CAMPAIGN_MANAGER_ADVERTISER","DISPLAY_VIDEO_PARTNER","DISPLAY_VIDEO_ADVERTISER","GOOGLE_ADS_CUSTOMER","GOOGLE_AD_MANAGER_NETWORK_CODE"]}},"required":["entityId","encryptedId","source","entityType"],"additionalProperties":false}},"dclid":{"type":"string","maxLength":100000},"sessionAttributes":{"type":"string","maxLength":100000}},"additionalProperties":false},"experimentalFields":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","maxLength":100000},"value":{"type":"string","maxLength":100000}},"additionalProperties":false}},"lastUpdatedTimestamp":{"type":"string","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)))$"},"eventTimestamp":{"type":"string","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)))$"},"eventDeviceInfo":{"type":"object","properties":{"languageCode":{"type":"string","maxLength":100000},"operatingSystem":{"type":"string","maxLength":100000},"brand":{"type":"string","maxLength":100000},"ipAddress":{"type":"string","maxLength":100000},"screenWidth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"model":{"type":"string","maxLength":100000},"userAgent":{"type":"string","maxLength":100000},"operatingSystemVersion":{"type":"string","maxLength":100000},"browser":{"type":"string","maxLength":100000},"category":{"type":"string","maxLength":100000},"screenHeight":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"browserVersion":{"type":"string","maxLength":100000}},"additionalProperties":false},"additionalEventParameters":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"value":{"type":"string","maxLength":100000},"parameterName":{"type":"string","maxLength":100000}},"required":["value","parameterName"],"additionalProperties":false}},"transactionId":{"type":"string","maxLength":100000},"userProperties":{"type":"object","properties":{"additionalUserProperties":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"value":{"type":"string","maxLength":100000},"propertyName":{"type":"string","maxLength":100000}},"required":["value","propertyName"],"additionalProperties":false}},"customerValueBucket":{"type":"string","enum":["CUSTOMER_VALUE_BUCKET_UNSPECIFIED","LOW","MEDIUM","HIGH"]},"customerType":{"type":"string","enum":["CUSTOMER_TYPE_UNSPECIFIED","NEW","RETURNING","REENGAGED"]}},"additionalProperties":false},"eventSource":{"type":"string","enum":["EVENT_SOURCE_UNSPECIFIED","WEB","APP","IN_STORE","PHONE","MESSAGE","OTHER"]},"consent":{"type":"object","properties":{"adUserData":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]},"adPersonalization":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]}},"additionalProperties":false},"cartData":{"type":"object","properties":{"merchantFeedLabel":{"type":"string","maxLength":100000},"merchantFeedLanguageCode":{"type":"string","maxLength":100000},"transactionDiscount":{"type":"number"},"items":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"merchantProductId":{"type":"string","maxLength":100000},"merchantFeedLabel":{"type":"string","maxLength":100000},"unitPrice":{"type":"number"},"additionalItemParameters":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"parameterName":{"type":"string","maxLength":100000},"value":{"type":"string","maxLength":100000}},"required":["parameterName","value"],"additionalProperties":false}},"itemId":{"type":"string","maxLength":100000},"merchantFeedLanguageCode":{"type":"string","maxLength":100000},"merchantId":{"type":"string","maxLength":100000},"conversionValue":{"type":"number"},"quantity":{"type":"string","maxLength":100000},"customVariables":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"variable":{"type":"string","maxLength":100000},"destinationReferences":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"value":{"type":"string","maxLength":100000}},"additionalProperties":false}}},"additionalProperties":false}},"merchantId":{"type":"string","maxLength":100000},"couponCodes":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"additionalProperties":false},"eventName":{"type":"string","maxLength":100000},"conversionValue":{"type":"number"},"userId":{"type":"string","maxLength":100000},"thirdPartyUserData":{"type":"object","properties":{"userIdentifiers":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"phoneNumber":{"type":"string","maxLength":100000},"address":{"type":"object","properties":{"regionCode":{"type":"string","maxLength":100000},"givenName":{"type":"string","maxLength":100000},"administrativeArea":{"type":"string","maxLength":100000},"addressLine":{"type":"string","maxLength":100000},"city":{"type":"string","maxLength":100000},"postalCode":{"type":"string","maxLength":100000},"familyName":{"type":"string","maxLength":100000}},"required":["regionCode","givenName","postalCode","familyName"],"additionalProperties":false},"emailAddress":{"type":"string","maxLength":100000}},"additionalProperties":false}}},"required":["userIdentifiers"],"additionalProperties":false},"eventLocation":{"type":"object","properties":{"subdivisionCode":{"type":"string","maxLength":100000},"subcontinentCode":{"type":"string","maxLength":100000},"storeId":{"type":"string","maxLength":100000},"continentCode":{"type":"string","maxLength":100000},"regionCode":{"type":"string","maxLength":100000},"city":{"type":"string","maxLength":100000}},"additionalProperties":false},"appInstanceId":{"type":"string","maxLength":100000},"destinationReferences":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"userData":{"type":"object","properties":{"userIdentifiers":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"phoneNumber":{"type":"string","maxLength":100000},"address":{"type":"object","properties":{"regionCode":{"type":"string","maxLength":100000},"givenName":{"type":"string","maxLength":100000},"administrativeArea":{"type":"string","maxLength":100000},"addressLine":{"type":"string","maxLength":100000},"city":{"type":"string","maxLength":100000},"postalCode":{"type":"string","maxLength":100000},"familyName":{"type":"string","maxLength":100000}},"required":["regionCode","givenName","postalCode","familyName"],"additionalProperties":false},"emailAddress":{"type":"string","maxLength":100000}},"additionalProperties":false}}},"required":["userIdentifiers"],"additionalProperties":false},"currency":{"type":"string","maxLength":100000},"customVariables":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"value":{"type":"string","maxLength":100000},"variable":{"type":"string","maxLength":100000},"destinationReferences":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"additionalProperties":false}},"clientId":{"type":"string","maxLength":100000},"conversionCount":{"type":"number"}},"required":["eventTimestamp"],"additionalProperties":false}},"encoding":{"type":"string","enum":["HEX","BASE64"]},"encryptionInfo":{"type":"object","properties":{"coordinatorKeyInfo":{"type":"object","properties":{"keyId":{"type":"string","maxLength":100000}},"required":["keyId"],"additionalProperties":false},"gcpWrappedKeyInfo":{"type":"object","properties":{"encryptedDek":{"type":"string","maxLength":100000},"keyType":{"type":"string","enum":["KEY_TYPE_UNSPECIFIED","XCHACHA20_POLY1305"]},"kekUri":{"type":"string","maxLength":100000},"wipProvider":{"type":"string","maxLength":100000}},"required":["encryptedDek","keyType","kekUri","wipProvider"],"additionalProperties":false},"awsWrappedKeyInfo":{"type":"object","properties":{"keyType":{"type":"string","enum":["KEY_TYPE_UNSPECIFIED","XCHACHA20_POLY1305"]},"roleArn":{"type":"string","maxLength":100000},"encryptedDek":{"type":"string","maxLength":100000},"kekUri":{"type":"string","maxLength":100000}},"required":["keyType","roleArn","encryptedDek","kekUri"],"additionalProperties":false}},"additionalProperties":false},"validateOnly":{"type":"boolean"},"consent":{"type":"object","properties":{"adUserData":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]},"adPersonalization":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]}},"additionalProperties":false}},"required":["destinationId","events"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_ingestConversions"}},"/accounts/{accountId}/native/google/ingestAudienceMembers":{"post":{"summary":"Prepare google ingestAudienceMembers (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"destinationId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"audienceMembers":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"pairData":{"type":"object","properties":{"pairIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["pairIds"],"additionalProperties":false},"destinationReferences":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"partnerProvidedIdData":{"type":"object","properties":{"partnerProvidedIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["partnerProvidedIds"],"additionalProperties":false},"compositeData":{"type":"object","properties":{"userData":{"type":"object","properties":{"userIdentifiers":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"phoneNumber":{"type":"string","maxLength":100000},"address":{"type":"object","properties":{"regionCode":{"type":"string","maxLength":100000},"givenName":{"type":"string","maxLength":100000},"administrativeArea":{"type":"string","maxLength":100000},"addressLine":{"type":"string","maxLength":100000},"city":{"type":"string","maxLength":100000},"postalCode":{"type":"string","maxLength":100000},"familyName":{"type":"string","maxLength":100000}},"required":["regionCode","givenName","postalCode","familyName"],"additionalProperties":false},"emailAddress":{"type":"string","maxLength":100000}},"additionalProperties":false}}},"required":["userIdentifiers"],"additionalProperties":false},"ipData":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"observeStartTime":{"type":"string","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)))$"},"ipAddress":{"type":"string","maxLength":100000},"observeEndTime":{"type":"string","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)))$"}},"required":["ipAddress"],"additionalProperties":false}}},"additionalProperties":false},"ppidData":{"type":"object","properties":{"ppids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["ppids"],"additionalProperties":false},"googleUserIdData":{"type":"object","properties":{"googleUserIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["googleUserIds"],"additionalProperties":false},"mobileData":{"type":"object","properties":{"mobileIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["mobileIds"],"additionalProperties":false},"userData":{"type":"object","properties":{"userIdentifiers":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"phoneNumber":{"type":"string","maxLength":100000},"address":{"type":"object","properties":{"regionCode":{"type":"string","maxLength":100000},"givenName":{"type":"string","maxLength":100000},"administrativeArea":{"type":"string","maxLength":100000},"addressLine":{"type":"string","maxLength":100000},"city":{"type":"string","maxLength":100000},"postalCode":{"type":"string","maxLength":100000},"familyName":{"type":"string","maxLength":100000}},"required":["regionCode","givenName","postalCode","familyName"],"additionalProperties":false},"emailAddress":{"type":"string","maxLength":100000}},"additionalProperties":false}}},"required":["userIdentifiers"],"additionalProperties":false},"userIdData":{"type":"object","properties":{"userId":{"type":"string","maxLength":100000}},"required":["userId"],"additionalProperties":false},"consent":{"type":"object","properties":{"adUserData":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]},"adPersonalization":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]}},"additionalProperties":false}},"additionalProperties":false}},"encoding":{"type":"string","enum":["HEX","BASE64"]},"encryptionInfo":{"type":"object","properties":{"coordinatorKeyInfo":{"type":"object","properties":{"keyId":{"type":"string","maxLength":100000}},"required":["keyId"],"additionalProperties":false},"gcpWrappedKeyInfo":{"type":"object","properties":{"encryptedDek":{"type":"string","maxLength":100000},"keyType":{"type":"string","enum":["KEY_TYPE_UNSPECIFIED","XCHACHA20_POLY1305"]},"kekUri":{"type":"string","maxLength":100000},"wipProvider":{"type":"string","maxLength":100000}},"required":["encryptedDek","keyType","kekUri","wipProvider"],"additionalProperties":false},"awsWrappedKeyInfo":{"type":"object","properties":{"keyType":{"type":"string","enum":["KEY_TYPE_UNSPECIFIED","XCHACHA20_POLY1305"]},"roleArn":{"type":"string","maxLength":100000},"encryptedDek":{"type":"string","maxLength":100000},"kekUri":{"type":"string","maxLength":100000}},"required":["keyType","roleArn","encryptedDek","kekUri"],"additionalProperties":false}},"additionalProperties":false},"validateOnly":{"type":"boolean"},"consent":{"type":"object","properties":{"adUserData":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]},"adPersonalization":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]}},"additionalProperties":false},"termsOfService":{"type":"object","properties":{"customerMatchTermsOfServiceStatus":{"type":"string","enum":["TERMS_OF_SERVICE_STATUS_UNSPECIFIED","ACCEPTED","REJECTED"]}},"additionalProperties":false}},"required":["destinationId","audienceMembers"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_ingestAudienceMembers"}},"/accounts/{accountId}/native/google/removeAudienceMembers":{"post":{"summary":"Prepare google removeAudienceMembers (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"destinationId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"audienceMembers":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"pairData":{"type":"object","properties":{"pairIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["pairIds"],"additionalProperties":false},"destinationReferences":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"partnerProvidedIdData":{"type":"object","properties":{"partnerProvidedIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["partnerProvidedIds"],"additionalProperties":false},"compositeData":{"type":"object","properties":{"userData":{"type":"object","properties":{"userIdentifiers":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"phoneNumber":{"type":"string","maxLength":100000},"address":{"type":"object","properties":{"regionCode":{"type":"string","maxLength":100000},"givenName":{"type":"string","maxLength":100000},"administrativeArea":{"type":"string","maxLength":100000},"addressLine":{"type":"string","maxLength":100000},"city":{"type":"string","maxLength":100000},"postalCode":{"type":"string","maxLength":100000},"familyName":{"type":"string","maxLength":100000}},"required":["regionCode","givenName","postalCode","familyName"],"additionalProperties":false},"emailAddress":{"type":"string","maxLength":100000}},"additionalProperties":false}}},"required":["userIdentifiers"],"additionalProperties":false},"ipData":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"observeStartTime":{"type":"string","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)))$"},"ipAddress":{"type":"string","maxLength":100000},"observeEndTime":{"type":"string","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)))$"}},"required":["ipAddress"],"additionalProperties":false}}},"additionalProperties":false},"ppidData":{"type":"object","properties":{"ppids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["ppids"],"additionalProperties":false},"googleUserIdData":{"type":"object","properties":{"googleUserIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["googleUserIds"],"additionalProperties":false},"mobileData":{"type":"object","properties":{"mobileIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["mobileIds"],"additionalProperties":false},"userData":{"type":"object","properties":{"userIdentifiers":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"phoneNumber":{"type":"string","maxLength":100000},"address":{"type":"object","properties":{"regionCode":{"type":"string","maxLength":100000},"givenName":{"type":"string","maxLength":100000},"administrativeArea":{"type":"string","maxLength":100000},"addressLine":{"type":"string","maxLength":100000},"city":{"type":"string","maxLength":100000},"postalCode":{"type":"string","maxLength":100000},"familyName":{"type":"string","maxLength":100000}},"required":["regionCode","givenName","postalCode","familyName"],"additionalProperties":false},"emailAddress":{"type":"string","maxLength":100000}},"additionalProperties":false}}},"required":["userIdentifiers"],"additionalProperties":false},"userIdData":{"type":"object","properties":{"userId":{"type":"string","maxLength":100000}},"required":["userId"],"additionalProperties":false},"consent":{"type":"object","properties":{"adUserData":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]},"adPersonalization":{"type":"string","enum":["CONSENT_STATUS_UNSPECIFIED","CONSENT_GRANTED","CONSENT_DENIED"]}},"additionalProperties":false}},"additionalProperties":false}},"encoding":{"type":"string","enum":["HEX","BASE64"]},"encryptionInfo":{"type":"object","properties":{"coordinatorKeyInfo":{"type":"object","properties":{"keyId":{"type":"string","maxLength":100000}},"required":["keyId"],"additionalProperties":false},"gcpWrappedKeyInfo":{"type":"object","properties":{"encryptedDek":{"type":"string","maxLength":100000},"keyType":{"type":"string","enum":["KEY_TYPE_UNSPECIFIED","XCHACHA20_POLY1305"]},"kekUri":{"type":"string","maxLength":100000},"wipProvider":{"type":"string","maxLength":100000}},"required":["encryptedDek","keyType","kekUri","wipProvider"],"additionalProperties":false},"awsWrappedKeyInfo":{"type":"object","properties":{"keyType":{"type":"string","enum":["KEY_TYPE_UNSPECIFIED","XCHACHA20_POLY1305"]},"roleArn":{"type":"string","maxLength":100000},"encryptedDek":{"type":"string","maxLength":100000},"kekUri":{"type":"string","maxLength":100000}},"required":["keyType","roleArn","encryptedDek","kekUri"],"additionalProperties":false}},"additionalProperties":false},"validateOnly":{"type":"boolean"}},"required":["destinationId","audienceMembers"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_removeAudienceMembers"}},"/accounts/{accountId}/native/google/getIngestionStatus":{"post":{"summary":"Read google getIngestionStatus (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"operationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["operationId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_getIngestionStatus"}},"/accounts/{accountId}/native/google/attachCampaignAssets":{"post":{"summary":"Prepare google attachCampaignAssets (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"sitelinks":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"linkText":{"type":"string","minLength":1,"maxLength":25},"finalUrls":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","format":"uri"}},"description1":{"type":"string","minLength":1,"maxLength":35},"description2":{"type":"string","minLength":1,"maxLength":35},"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"},"adScheduleTargets":{"maxItems":42,"type":"array","items":{"type":"object","properties":{"dayOfWeek":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]},"startHour":{"type":"integer","minimum":0,"maximum":23},"endHour":{"type":"integer","minimum":0,"maximum":24},"startMinute":{"type":"string","enum":["ZERO","FIFTEEN","THIRTY","FORTY_FIVE"]},"endMinute":{"type":"string","enum":["ZERO","FIFTEEN","THIRTY","FORTY_FIVE"]}},"required":["dayOfWeek","startHour","endHour","startMinute","endMinute"],"additionalProperties":false}}},"required":["linkText","finalUrls"],"additionalProperties":false}},"callouts":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"calloutText":{"type":"string","minLength":1,"maxLength":25},"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["calloutText"],"additionalProperties":false}},"structuredSnippets":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"header":{"type":"string","minLength":1,"maxLength":25},"values":{"minItems":3,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":25}}},"required":["header","values"],"additionalProperties":false}}},"required":["campaignId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_attachCampaignAssets"}},"/accounts/{accountId}/native/google/listCampaignAssets":{"post":{"summary":"Read google listCampaignAssets (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["campaignId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_listCampaignAssets"}},"/accounts/{accountId}/native/google/listConversionActions":{"post":{"summary":"Read google listConversionActions (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_listConversionActions"}},"/accounts/{accountId}/native/google/getConversionAction":{"post":{"summary":"Read google getConversionAction (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"destinationId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["destinationId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_getConversionAction"}},"/accounts/{accountId}/native/google/createConversionAction":{"post":{"summary":"Prepare google createConversionAction (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"action":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"category":{"type":"string","enum":["DEFAULT","PAGE_VIEW","PURCHASE","SIGNUP","DOWNLOAD","ADD_TO_CART","BEGIN_CHECKOUT","SUBSCRIBE_PAID","PHONE_CALL_LEAD","IMPORTED_LEAD","SUBMIT_LEAD_FORM","BOOK_APPOINTMENT","REQUEST_QUOTE","GET_DIRECTIONS","OUTBOUND_CLICK","CONTACT","ENGAGEMENT","STORE_VISIT","STORE_SALE","QUALIFIED_LEAD","CONVERTED_LEAD","YOUTUBE_FOLLOW_ON_VIEWS"]},"primaryForGoal":{"type":"boolean"},"countingType":{"type":"string","enum":["ONE_PER_CLICK","MANY_PER_CLICK"]},"clickThroughLookbackWindowDays":{"type":"integer","minimum":1,"maximum":90},"viewThroughLookbackWindowDays":{"type":"integer","minimum":1,"maximum":30},"valueSettings":{"type":"object","properties":{"defaultValue":{"type":"number"},"defaultCurrencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"alwaysUseDefaultValue":{"type":"boolean"}},"required":["defaultValue"],"additionalProperties":false}},"required":["name","category"],"additionalProperties":false}},"required":["action"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_createConversionAction"}},"/accounts/{accountId}/native/google/updateConversionAction":{"post":{"summary":"Prepare google updateConversionAction (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"destinationId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"changes":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"primaryForGoal":{"type":"boolean"},"countingType":{"type":"string","enum":["ONE_PER_CLICK","MANY_PER_CLICK"]},"clickThroughLookbackWindowDays":{"type":"integer","minimum":1,"maximum":90},"viewThroughLookbackWindowDays":{"type":"integer","minimum":1,"maximum":30},"attributionModel":{"type":"string","enum":["GOOGLE_ADS_LAST_CLICK","GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN"]},"status":{"type":"string","enum":["ENABLED","HIDDEN"]}},"additionalProperties":false}},"required":["destinationId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_updateConversionAction"}},"/accounts/{accountId}/native/google/adjustConversions":{"post":{"summary":"Prepare google adjustConversions (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"destinationId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"adjustments":{"minItems":1,"maxItems":2000,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["RETRACTION","RESTATEMENT","ENHANCEMENT"]},"orderId":{"type":"string","minLength":1,"maxLength":256},"gclid":{"type":"string","minLength":1,"maxLength":2048},"conversionTime":{"type":"integer","exclusiveMinimum":0,"maximum":253402300799},"adjustmentTime":{"type":"integer","exclusiveMinimum":0,"maximum":253402300799},"restatementValue":{"type":"number"},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"userIdentifiers":{"minItems":1,"maxItems":5,"type":"array","items":{"anyOf":[{"type":"object","properties":{"hashedEmail":{"type":"string","pattern":"^[a-f0-9]{64}$"},"userIdentifierSource":{"type":"string","const":"FIRST_PARTY"}},"required":["hashedEmail"],"additionalProperties":false},{"type":"object","properties":{"hashedPhoneNumber":{"type":"string","pattern":"^[a-f0-9]{64}$"},"userIdentifierSource":{"type":"string","const":"FIRST_PARTY"}},"required":["hashedPhoneNumber"],"additionalProperties":false}]}},"userAgent":{"type":"string","minLength":1,"maxLength":2048}},"required":["type","adjustmentTime"],"additionalProperties":false}},"validateOnly":{"type":"boolean"}},"required":["destinationId","adjustments"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_adjustConversions"}},"/accounts/{accountId}/native/google/listAudiences":{"post":{"summary":"Read google listAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_listAudiences"}},"/accounts/{accountId}/native/google/getAudience":{"post":{"summary":"Read google getAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audienceId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["audienceId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_getAudience"}},"/accounts/{accountId}/native/google/createAudience":{"post":{"summary":"Prepare google createAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audience":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"type":"string","maxLength":1000},"membershipStatus":{"type":"string","enum":["OPEN","CLOSED"]},"membershipLifeSpan":{"type":"integer","minimum":0,"maximum":540},"uploadKeyType":{"type":"string","enum":["CONTACT_INFO","CRM_ID","MOBILE_ADVERTISING_ID"]},"appId":{"type":"string","minLength":1,"maxLength":255}},"required":["name","uploadKeyType"],"additionalProperties":false}},"required":["audience"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_createAudience"}},"/accounts/{accountId}/native/google/updateAudience":{"post":{"summary":"Prepare google updateAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audienceId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"changes":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"type":"string","maxLength":1000},"membershipStatus":{"type":"string","enum":["OPEN","CLOSED"]},"membershipLifeSpan":{"type":"integer","minimum":0,"maximum":540}},"additionalProperties":false}},"required":["audienceId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_updateAudience"}},"/accounts/{accountId}/native/google/deleteAudience":{"post":{"summary":"Prepare google deleteAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audienceId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["audienceId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_deleteAudience"}},"/accounts/{accountId}/native/google/listChangeEvents":{"post":{"summary":"Read google listChangeEvents (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"},"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["startDate","endDate"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_listChangeEvents"}},"/accounts/{accountId}/native/google/listRecommendations":{"post":{"summary":"Read google listRecommendations (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignId":{"type":"string","pattern":"^(\\d{1,30}|customers\\/\\d{10}\\/campaigns\\/\\d{1,30})$"}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_listRecommendations"}},"/accounts/{accountId}/native/google/applyRecommendation":{"post":{"summary":"Prepare google applyRecommendation (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"recommendationId":{"type":"string","maxLength":100000}},"required":["recommendationId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_applyRecommendation"}},"/accounts/{accountId}/native/google/dismissRecommendation":{"post":{"summary":"Prepare google dismissRecommendation (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"recommendationId":{"type":"string","maxLength":100000}},"required":["recommendationId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_dismissRecommendation"}},"/accounts/{accountId}/native/google/listNegativeKeywordLists":{"post":{"summary":"Read google listNegativeKeywordLists (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_listNegativeKeywordLists"}},"/accounts/{accountId}/native/google/getNegativeKeywordList":{"post":{"summary":"Read google getNegativeKeywordList (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"listId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["listId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_google_getNegativeKeywordList"}},"/accounts/{accountId}/native/google/createNegativeKeywordList":{"post":{"summary":"Prepare google createNegativeKeywordList (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"keywords":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":80},"matchType":{"default":"BROAD","type":"string","enum":["BROAD","PHRASE","EXACT"]}},"required":["text","matchType"],"additionalProperties":false}},"accountLevel":{"type":"boolean"}},"required":["name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_createNegativeKeywordList"}},"/accounts/{accountId}/native/google/updateNegativeKeywordList":{"post":{"summary":"Prepare google updateNegativeKeywordList (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"listId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"add":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":80},"matchType":{"default":"BROAD","type":"string","enum":["BROAD","PHRASE","EXACT"]}},"required":["text","matchType"],"additionalProperties":false}},"remove":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["listId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_google_updateNegativeKeywordList"}},"/accounts/{accountId}/native/pinterest/listAudiences":{"post":{"summary":"Read pinterest listAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listAudiences"}},"/accounts/{accountId}/native/pinterest/getAudience":{"post":{"summary":"Read pinterest getAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audienceId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["audienceId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_getAudience"}},"/accounts/{accountId}/native/pinterest/createAudience":{"post":{"summary":"Prepare pinterest createAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audience":{"oneOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"audience_type":{"type":"string","const":"CUSTOMER_LIST"},"rule":{"type":"object","properties":{"customer_list_id":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["customer_list_id"],"additionalProperties":false}},"required":["name","audience_type","rule"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"audience_type":{"type":"string","const":"ACTALIKE"},"rule":{"type":"object","properties":{"seed_id":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"country":{"type":"string","enum":["US","CA","GB"]},"percentage":{"type":"integer","minimum":1,"maximum":10}},"required":["seed_id","country","percentage"],"additionalProperties":false}},"required":["name","audience_type","rule"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"audience_type":{"type":"string","const":"VISITOR"},"rule":{"type":"object","properties":{"visitor_source_id":{"anyOf":[{"type":"string","maxLength":30,"pattern":"^\\d+$"},{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}}]},"retention_days":{"type":"integer","minimum":1,"maximum":540},"event":{"type":"string","minLength":1,"maxLength":100},"prefill":{"type":"boolean"},"event_source":{"type":"object","properties":{"=":{"minItems":1,"type":"array","items":{"type":"string","enum":["web","mobile","offline"]}}},"required":["="],"additionalProperties":false},"ingestion_source":{"type":"object","properties":{"=":{"minItems":1,"type":"array","items":{"type":"string","enum":["tag","mmp","file_upload","conversions_api"]}}},"required":["="],"additionalProperties":false}},"required":["visitor_source_id"],"additionalProperties":false}},"required":["name","audience_type","rule"],"additionalProperties":false},{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"audience_type":{"type":"string","const":"ENGAGEMENT"},"rule":{"type":"object","properties":{"engagement_domain":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":255}},"engager_type":{"type":"integer","minimum":1,"maximum":2},"engagement_type":{"type":"string","enum":["click","save","closeup","comment","like"]},"retention_days":{"type":"integer","minimum":1,"maximum":540},"ad_id":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"campaign_id":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"pin_id":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}}},"required":["engagement_domain"],"additionalProperties":false}},"required":["name","audience_type","rule"],"additionalProperties":false}]}},"required":["audience"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createAudience"}},"/accounts/{accountId}/native/pinterest/updateAudience":{"post":{"summary":"Prepare pinterest updateAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audienceId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"changes":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]}},"additionalProperties":false}},"required":["audienceId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_updateAudience"}},"/accounts/{accountId}/native/pinterest/deleteAudience":{"post":{"summary":"Prepare pinterest deleteAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audienceId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["audienceId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_deleteAudience"}},"/accounts/{accountId}/native/pinterest/listCustomerLists":{"post":{"summary":"Read pinterest listCustomerLists (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listCustomerLists"}},"/accounts/{accountId}/native/pinterest/getCustomerList":{"post":{"summary":"Read pinterest getCustomerList (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"customerListId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["customerListId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_getCustomerList"}},"/accounts/{accountId}/native/pinterest/createCustomerList":{"post":{"summary":"Prepare pinterest createCustomerList (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"list":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"list_type":{"type":"string","enum":["EMAIL","IDFA","MAID","HASHED_PINNER_ID"]},"records":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","pattern":"^(?:[a-fA-F0-9]{32}|[a-fA-F0-9]{40}|[a-fA-F0-9]{64})$"}}},"required":["name","list_type","records"],"additionalProperties":false}},"required":["list"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createCustomerList"}},"/accounts/{accountId}/native/pinterest/updateCustomerList":{"post":{"summary":"Prepare pinterest updateCustomerList (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"customerListId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"changes":{"type":"object","properties":{"operation_type":{"type":"string","enum":["ADD","REMOVE"]},"records":{"minItems":1,"maxItems":10000,"type":"array","items":{"type":"string","pattern":"^(?:[a-fA-F0-9]{32}|[a-fA-F0-9]{40}|[a-fA-F0-9]{64})$"}}},"required":["operation_type","records"],"additionalProperties":false}},"required":["customerListId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_updateCustomerList"}},"/accounts/{accountId}/native/pinterest/listLeadForms":{"post":{"summary":"Read pinterest listLeadForms (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listLeadForms"}},"/accounts/{accountId}/native/pinterest/getLeadForm":{"post":{"summary":"Read pinterest getLeadForm (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"leadFormId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["leadFormId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_getLeadForm"}},"/accounts/{accountId}/native/pinterest/createLeadForm":{"post":{"summary":"Prepare pinterest createLeadForm (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"form":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"privacy_policy_link":{"type":"string","maxLength":2000,"format":"uri"},"completion_message":{"type":"string","minLength":1,"maxLength":500},"disclosure_language":{"type":"string","maxLength":2000},"policy_links":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":100},"link":{"type":"string","maxLength":2000,"format":"uri"}},"required":["label","link"],"additionalProperties":false}},"questions":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"question_type":{"type":"string","enum":["CUSTOM","FULL_NAME","FIRST_NAME","LAST_NAME","EMAIL","PHONE_NUMBER","ZIP_CODE","GENDER","CITY","COUNTRY","STATE_PROVINCE","ADDRESS","DATE_OF_BIRTH","AGE"]},"custom_question_field_type":{"type":"string","enum":["TEXT_FIELD","TEXT_AREA","RADIO_LIST","CHECKBOX"]},"custom_question_label":{"type":"string","maxLength":200},"custom_question_options":{"maxItems":5,"type":"array","items":{"type":"string","maxLength":100}}},"required":["question_type"],"additionalProperties":false}},"status":{"type":"string","enum":["DRAFT","ACTIVE"]},"has_accepted_terms":{"type":"boolean","const":true}},"required":["name","privacy_policy_link","completion_message","questions","has_accepted_terms"],"additionalProperties":false}},"required":["form"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createLeadForm"}},"/accounts/{accountId}/native/pinterest/updateLeadForm":{"post":{"summary":"Prepare pinterest updateLeadForm (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"leadFormId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"changes":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"privacy_policy_link":{"type":"string","maxLength":2000,"format":"uri"},"completion_message":{"type":"string","minLength":1,"maxLength":500},"disclosure_language":{"type":"string","maxLength":2000},"policy_links":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"label":{"type":"string","maxLength":100},"link":{"type":"string","maxLength":2000,"format":"uri"}},"required":["label","link"],"additionalProperties":false}},"questions":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"question_type":{"type":"string","enum":["CUSTOM","FULL_NAME","FIRST_NAME","LAST_NAME","EMAIL","PHONE_NUMBER","ZIP_CODE","GENDER","CITY","COUNTRY","STATE_PROVINCE","ADDRESS","DATE_OF_BIRTH","AGE"]},"custom_question_field_type":{"type":"string","enum":["TEXT_FIELD","TEXT_AREA","RADIO_LIST","CHECKBOX"]},"custom_question_label":{"type":"string","maxLength":200},"custom_question_options":{"maxItems":5,"type":"array","items":{"type":"string","maxLength":100}}},"required":["question_type"],"additionalProperties":false}},"status":{"type":"string","enum":["DRAFT","ACTIVE"]}},"additionalProperties":false}},"required":["leadFormId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_updateLeadForm"}},"/accounts/{accountId}/native/pinterest/exportLeads":{"post":{"summary":"Prepare pinterest exportLeads (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"start_date":{"type":"string","format":"date","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])))$"},"end_date":{"type":"string","format":"date","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])))$"}},"required":["adId","start_date","end_date"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_exportLeads"}},"/accounts/{accountId}/native/pinterest/getLeadsExport":{"post":{"summary":"Read pinterest getLeadsExport (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"exportId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,200}$"}},"required":["exportId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_getLeadsExport"}},"/accounts/{accountId}/native/pinterest/listLeadWebhooks":{"post":{"summary":"Read pinterest listLeadWebhooks (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listLeadWebhooks"}},"/accounts/{accountId}/native/pinterest/createLeadWebhook":{"post":{"summary":"Prepare pinterest createLeadWebhook (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"webhook_url":{"type":"string","maxLength":2000,"format":"uri"},"lead_form_id":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["webhook_url"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createLeadWebhook"}},"/accounts/{accountId}/native/pinterest/deleteLeadWebhook":{"post":{"summary":"Prepare pinterest deleteLeadWebhook (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"subscriptionId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["subscriptionId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_deleteLeadWebhook"}},"/accounts/{accountId}/native/pinterest/listConversionTags":{"post":{"summary":"Read pinterest listConversionTags (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listConversionTags"}},"/accounts/{accountId}/native/pinterest/createConversionTag":{"post":{"summary":"Prepare pinterest createConversionTag (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"tag":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"aem_enabled":{"type":"boolean"},"aem_ph_enabled":{"type":"boolean"},"aem_ge_enabled":{"type":"boolean"},"aem_db_enabled":{"type":"boolean"},"aem_loc_enabled":{"type":"boolean"},"aem_fnln_enabled":{"type":"boolean"},"aem_external_id_enabled":{"type":"boolean"},"md_frequency":{"type":"number"}},"required":["name"],"additionalProperties":false}},"required":["tag"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createConversionTag"}},"/accounts/{accountId}/native/pinterest/sendConversionEvents":{"post":{"summary":"Prepare pinterest sendConversionEvents (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"data":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"event_name":{"type":"string","minLength":1,"maxLength":100},"action_source":{"type":"string","enum":["app_android","app_ios","web","offline"]},"event_time":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"event_id":{"type":"string","minLength":1,"maxLength":200},"event_source_url":{"type":"string","maxLength":2000,"format":"uri"},"opt_out":{"type":"boolean"},"partner_name":{"type":"string","maxLength":100},"user_data":{"type":"object","properties":{"em":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"ph":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"ge":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"db":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"ln":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"fn":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"ct":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"st":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"zp":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"country":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"external_id":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"hashed_maids":{"maxItems":10,"type":"array","items":{"type":"string","pattern":"^[a-fA-F0-9]{64}$"}},"click_id":{"type":"string","maxLength":500},"partner_id":{"type":"string","maxLength":500},"client_ip_address":{"type":"string","maxLength":100},"client_user_agent":{"type":"string","maxLength":2000}},"additionalProperties":false},"custom_data":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"app_id":{"type":"string","maxLength":200},"app_name":{"type":"string","maxLength":200},"app_version":{"type":"string","maxLength":100},"device_brand":{"type":"string","maxLength":100},"device_carrier":{"type":"string","maxLength":100},"device_model":{"type":"string","maxLength":100},"device_type":{"type":"string","maxLength":100},"os_version":{"type":"string","maxLength":100},"language":{"type":"string","maxLength":20}},"required":["event_name","action_source","event_time","event_id","user_data"],"additionalProperties":false}},"test":{"type":"boolean"}},"required":["data"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_sendConversionEvents"}},"/accounts/{accountId}/native/pinterest/listTargetingTemplates":{"post":{"summary":"Read pinterest listTargetingTemplates (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listTargetingTemplates"}},"/accounts/{accountId}/native/pinterest/createTargetingTemplate":{"post":{"summary":"Prepare pinterest createTargetingTemplate (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"template":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"targeting_attributes":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z_]+$"},"additionalProperties":{}},"auto_targeting_enabled":{"type":"boolean"},"placement_group":{"type":"string","enum":["ALL","SEARCH","BROWSE","OTHER"]},"keywords":{"maxItems":25000,"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1,"maxLength":120},"match_type":{"type":"string","enum":["BROAD","PHRASE","EXACT","EXACT_NEGATIVE","PHRASE_NEGATIVE"]}},"required":["value","match_type"],"additionalProperties":false}}},"required":["name","targeting_attributes"],"additionalProperties":false}},"required":["template"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createTargetingTemplate"}},"/accounts/{accountId}/native/pinterest/updateTargetingTemplate":{"post":{"summary":"Prepare pinterest updateTargetingTemplate (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"templateId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"targeting_attributes":{"type":"object","propertyNames":{"type":"string","pattern":"^[A-Z_]+$"},"additionalProperties":{}},"operation_type":{"type":"string","enum":["UPDATE","REMOVE"]}},"required":["templateId","operation_type"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_updateTargetingTemplate"}},"/accounts/{accountId}/native/pinterest/listCatalogs":{"post":{"summary":"Read pinterest listCatalogs (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listCatalogs"}},"/accounts/{accountId}/native/pinterest/createCatalog":{"post":{"summary":"Prepare pinterest createCatalog (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"catalog_type":{"type":"string","enum":["RETAIL","HOTEL","CREATIVE_ASSETS"]}},"required":["name","catalog_type"],"additionalProperties":false}},"required":["catalog"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createCatalog"}},"/accounts/{accountId}/native/pinterest/listCatalogFeeds":{"post":{"summary":"Read pinterest listCatalogFeeds (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalogId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listCatalogFeeds"}},"/accounts/{accountId}/native/pinterest/createCatalogFeed":{"post":{"summary":"Prepare pinterest createCatalogFeed (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"feed":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"catalog_type":{"type":"string","enum":["RETAIL","HOTEL","CREATIVE_ASSETS"]},"catalog_id":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"format":{"type":"string","enum":["TSV","CSV","XML"]},"location":{"type":"string","maxLength":2000,"format":"uri"},"default_country":{"type":"string","pattern":"^[A-Z]{2}$"},"default_locale":{"type":"string","minLength":2,"maxLength":10},"default_currency":{"type":"string","pattern":"^[A-Z]{3}$"},"default_availability":{"type":"string","enum":["IN_STOCK","OUT_OF_STOCK","PREORDER"]},"preferred_processing_schedule":{"type":"object","properties":{"time":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"timezone":{"type":"string","maxLength":60}},"required":["time"],"additionalProperties":false},"status":{"type":"string","enum":["ACTIVE","INACTIVE"]}},"required":["name","catalog_type","format","location","default_country","default_locale"],"additionalProperties":false}},"required":["feed"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createCatalogFeed"}},"/accounts/{accountId}/native/pinterest/updateCatalogFeed":{"post":{"summary":"Prepare pinterest updateCatalogFeed (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"feedId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"changes":{"type":"object","properties":{"catalog_type":{"type":"string","enum":["RETAIL","HOTEL","CREATIVE_ASSETS"]},"name":{"type":"string","minLength":1,"maxLength":255},"format":{"type":"string","enum":["TSV","CSV","XML"]},"location":{"type":"string","maxLength":2000,"format":"uri"},"default_currency":{"type":"string","pattern":"^[A-Z]{3}$"},"default_availability":{"type":"string","enum":["IN_STOCK","OUT_OF_STOCK","PREORDER"]},"preferred_processing_schedule":{"type":"object","properties":{"time":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"timezone":{"type":"string","maxLength":60}},"required":["time"],"additionalProperties":false},"status":{"type":"string","enum":["ACTIVE","INACTIVE"]}},"required":["catalog_type"],"additionalProperties":false}},"required":["feedId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_updateCatalogFeed"}},"/accounts/{accountId}/native/pinterest/ingestCatalogFeed":{"post":{"summary":"Prepare pinterest ingestCatalogFeed (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"feedId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["feedId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_ingestCatalogFeed"}},"/accounts/{accountId}/native/pinterest/listProductGroups":{"post":{"summary":"Read pinterest listProductGroups (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"feedId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listProductGroups"}},"/accounts/{accountId}/native/pinterest/createProductGroup":{"post":{"summary":"Prepare pinterest createProductGroup (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"group":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"catalog_type":{"type":"string","enum":["RETAIL","HOTEL","CREATIVE_ASSETS"]},"catalog_id":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"feed_id":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"filters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":{"type":"string","maxLength":1000},"is_featured":{"type":"boolean"},"country":{"type":"string","maxLength":2},"locale":{"type":"string","maxLength":10}},"required":["name","catalog_type","catalog_id","feed_id","filters"],"additionalProperties":false}},"required":["group"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createProductGroup"}},"/accounts/{accountId}/native/pinterest/updateProductGroup":{"post":{"summary":"Prepare pinterest updateProductGroup (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"productGroupId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"changes":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"catalog_type":{"type":"string","enum":["RETAIL","HOTEL","CREATIVE_ASSETS"]},"filters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"description":{"type":"string","maxLength":1000},"is_featured":{"type":"boolean"},"country":{"type":"string","maxLength":2},"locale":{"type":"string","maxLength":10}},"additionalProperties":false}},"required":["productGroupId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_updateProductGroup"}},"/accounts/{accountId}/native/pinterest/deleteProductGroup":{"post":{"summary":"Prepare pinterest deleteProductGroup (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"productGroupId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["productGroupId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_deleteProductGroup"}},"/accounts/{accountId}/native/pinterest/listLabels":{"post":{"summary":"Read pinterest listLabels (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listLabels"}},"/accounts/{accountId}/native/pinterest/createLabels":{"post":{"summary":"Prepare pinterest createLabels (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"labels":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"label_type":{"type":"string","enum":["BRAND","CUSTOM"]},"value":{"type":"string","minLength":1,"maxLength":100}},"required":["label_type","value"],"additionalProperties":false}}},"required":["labels"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createLabels"}},"/accounts/{accountId}/native/pinterest/applyLabel":{"post":{"summary":"Prepare pinterest applyLabel (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"labelId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"campaignIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}}},"required":["labelId","campaignIds"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_applyLabel"}},"/accounts/{accountId}/native/pinterest/removeLabel":{"post":{"summary":"Prepare pinterest removeLabel (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"labelId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"campaignIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}}},"required":["labelId","campaignIds"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_removeLabel"}},"/accounts/{accountId}/native/pinterest/listSchedules":{"post":{"summary":"Read pinterest listSchedules (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"bookmark":{"type":"string","maxLength":100000},"page_size":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_pinterest_listSchedules"}},"/accounts/{accountId}/native/pinterest/createSchedules":{"post":{"summary":"Prepare pinterest createSchedules (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"schedules":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":255},"entity_id":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"entity_type":{"type":"string","enum":["CAMPAIGN","AD_GROUP"]},"schedule_type":{"type":"string","enum":["CAMPAIGN_BUDGET_CHANGE","CAMPAIGN_BID_MULTIPLIERS"]},"schedule_action":{"type":"string","enum":["INCREASE_BY_VALUE","INCREASE_BY_PERCENT"]},"delta_value":{},"start_timestamp":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"end_timestamp":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["entity_id","schedule_type","start_timestamp"],"additionalProperties":false}}},"required":["schedules"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_createSchedules"}},"/accounts/{accountId}/native/pinterest/updateSchedules":{"post":{"summary":"Prepare pinterest updateSchedules (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"schedules":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"schedule_id":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"name":{"type":"string","maxLength":255},"entity_id":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"entity_type":{"type":"string","enum":["CAMPAIGN","AD_GROUP"]},"schedule_type":{"type":"string","enum":["CAMPAIGN_BUDGET_CHANGE","CAMPAIGN_BID_MULTIPLIERS"]},"schedule_action":{"type":"string","enum":["INCREASE_BY_VALUE","INCREASE_BY_PERCENT"]},"delta_value":{},"start_timestamp":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"end_timestamp":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"schedule_status":{"type":"string","enum":["DRAFT","CREATED","SCHEDULED","ACTIVE","COMPLETED","FAILED","CANCELED"]}},"required":["id","schedule_id"],"additionalProperties":false}}},"required":["schedules"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_pinterest_updateSchedules"}},"/accounts/{accountId}/native/tiktok/listAudiences":{"post":{"summary":"Read tiktok listAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"custom_audience_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listAudiences"}},"/accounts/{accountId}/native/tiktok/getAudiences":{"post":{"summary":"Read tiktok getAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"custom_audience_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"history_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["custom_audience_ids"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_getAudiences"}},"/accounts/{accountId}/native/tiktok/createAudience":{"post":{"summary":"Prepare tiktok createAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audience_enhancement":{"type":"boolean"},"audience_sub_type":{"type":"string","maxLength":100000},"calculate_type":{"type":"string","maxLength":100000},"custom_audience_name":{"type":"string","maxLength":100000},"file_paths":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"retention_in_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["calculate_type","custom_audience_name","file_paths"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createAudience"}},"/accounts/{accountId}/native/tiktok/createRuleAudience":{"post":{"summary":"Prepare tiktok createRuleAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"audience_sub_type":{"type":"string","maxLength":100000},"audience_type":{"type":"string","maxLength":100000},"custom_audience_name":{"type":"string","maxLength":100000},"identity_authorized_bc_id":{"type":"string","maxLength":100000},"identity_id":{"type":"string","maxLength":100000},"identity_type":{"type":"string","maxLength":100000},"is_auto_refresh":{"type":"boolean"},"retention_in_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rule_spec":{"type":"object","properties":{"exclusion_rule_set":{"type":"object","properties":{"operator":{"type":"string","maxLength":100000},"rules":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"event_source_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"filter_set":{"type":"object","properties":{"filters":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","maxLength":100000},"operator":{"type":"string","maxLength":100000},"parameter_filters":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","maxLength":100000},"operator":{"type":"string","maxLength":100000},"values":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["field","operator","values"],"additionalProperties":false}},"value":{"type":"string","maxLength":100000}},"required":["field","operator","value"],"additionalProperties":false}},"operator":{"type":"string","maxLength":100000}},"required":["filters","operator"],"additionalProperties":false},"retention_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["retention_days"],"additionalProperties":false}}},"required":["operator","rules"],"additionalProperties":false},"inclusion_rule_set":{"type":"object","properties":{"operator":{"type":"string","maxLength":100000},"rules":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"event_source_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"filter_set":{"type":"object","properties":{"filters":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","maxLength":100000},"operator":{"type":"string","maxLength":100000},"parameter_filters":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","maxLength":100000},"operator":{"type":"string","maxLength":100000},"values":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["field","operator","values"],"additionalProperties":false}},"value":{"type":"string","maxLength":100000}},"required":["field","operator","value"],"additionalProperties":false}},"operator":{"type":"string","maxLength":100000}},"required":["filters","operator"],"additionalProperties":false},"retention_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["retention_days"],"additionalProperties":false}}},"required":["operator","rules"],"additionalProperties":false}},"required":["inclusion_rule_set"],"additionalProperties":false}},"required":["audience_type","custom_audience_name","rule_spec"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createRuleAudience"}},"/accounts/{accountId}/native/tiktok/createLookalikeAudience":{"post":{"summary":"Prepare tiktok createLookalikeAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"context_info":{"type":"object","properties":{"app_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"core_user_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"developer_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},"custom_audience_name":{"type":"string","maxLength":100000},"lookalike_spec":{"type":"object","properties":{"audience_size":{"type":"string","maxLength":100000},"include_source":{"type":"boolean"},"location_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"mobile_os":{"type":"string","maxLength":100000},"placements":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"source_audience_id":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["custom_audience_name","lookalike_spec"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createLookalikeAudience"}},"/accounts/{accountId}/native/tiktok/updateLookalikeAudience":{"post":{"summary":"Prepare tiktok updateLookalikeAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"context_info":{"type":"object","properties":{"app_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"core_user_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"developer_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"x_forwarded_for":{"type":"string","maxLength":100000},"x_real_ip":{"type":"string","maxLength":100000}},"additionalProperties":false},"custom_audience_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["custom_audience_ids"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_updateLookalikeAudience"}},"/accounts/{accountId}/native/tiktok/updateAudience":{"post":{"summary":"Prepare tiktok updateAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"action":{"type":"string","maxLength":100000},"audience_enhancement":{"type":"boolean"},"audience_sub_type":{"type":"string","maxLength":100000},"context_info":{"type":"object","properties":{"core_user_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},"custom_audience_id":{"type":"string","maxLength":100000},"custom_audience_name":{"type":"string","maxLength":100000},"file_paths":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["custom_audience_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_updateAudience"}},"/accounts/{accountId}/native/tiktok/deleteAudiences":{"post":{"summary":"Prepare tiktok deleteAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"custom_audience_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["custom_audience_ids"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_deleteAudiences"}},"/accounts/{accountId}/native/tiktok/listSavedAudiences":{"post":{"summary":"Read tiktok listSavedAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"saved_audience_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listSavedAudiences"}},"/accounts/{accountId}/native/tiktok/createSavedAudience":{"post":{"summary":"Prepare tiktok createSavedAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"actions":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"action_category_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"action_period":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"action_scene":{"type":"string","maxLength":100000},"video_user_actions":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"additionalProperties":false}},"age_groups":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"audience_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"carrier_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"device_model_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"device_price_ranges":{"maxItems":10000,"type":"array","items":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"excluded_audience_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"gender":{"type":"string","maxLength":100000},"interest_category_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"interest_keyword_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"languages":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"location_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"min_android_version":{"type":"string","maxLength":100000},"min_ios_version":{"type":"string","maxLength":100000},"network_types":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"operating_systems":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"saved_audience_name":{"type":"string","maxLength":100000}},"required":["location_ids","saved_audience_name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createSavedAudience"}},"/accounts/{accountId}/native/tiktok/deleteSavedAudiences":{"post":{"summary":"Prepare tiktok deleteSavedAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"saved_audience_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["saved_audience_ids"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_deleteSavedAudiences"}},"/accounts/{accountId}/native/tiktok/listPixels":{"post":{"summary":"Read tiktok listPixels (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"pixel_id":{"type":"string","maxLength":100000},"code":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000},"order_by":{"type":"string","maxLength":100000},"filtering":{"type":"object","properties":{"available_for_catalog_only":{"type":"boolean"}},"additionalProperties":false},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listPixels"}},"/accounts/{accountId}/native/tiktok/createPixel":{"post":{"summary":"Prepare tiktok createPixel (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"partner_name":{"type":"string","maxLength":100000},"pixel_category":{"type":"string","maxLength":100000},"pixel_name":{"type":"string","maxLength":100000}},"required":["pixel_name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createPixel"}},"/accounts/{accountId}/native/tiktok/updatePixel":{"post":{"summary":"Prepare tiktok updatePixel (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"advanced_matching_fields":{"type":"object","properties":{"email":{"type":"boolean"},"phone_number":{"type":"boolean"}},"additionalProperties":false},"pixel_id":{"type":"string","maxLength":100000},"pixel_name":{"type":"string","maxLength":100000}},"required":["pixel_id","pixel_name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_updatePixel"}},"/accounts/{accountId}/native/tiktok/createPixelEvent":{"post":{"summary":"Prepare tiktok createPixelEvent (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"pixel_events":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","maxLength":100000},"currency_value":{"type":"string","maxLength":100000},"event_code":{"type":"string","maxLength":100000},"event_id":{"type":"string","maxLength":100000},"event_name":{"type":"string","maxLength":100000},"event_type":{"type":"string","maxLength":100000},"rules":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"operator":{"type":"string","maxLength":100000},"trigger":{"type":"string","maxLength":100000},"value":{"type":"string","maxLength":100000},"variable":{"type":"string","maxLength":100000}},"required":["operator","trigger","value","variable"],"additionalProperties":false}},"statistic_type":{"type":"string","maxLength":100000}},"additionalProperties":false}},"pixel_id":{"type":"string","maxLength":100000}},"required":["pixel_events","pixel_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createPixelEvent"}},"/accounts/{accountId}/native/tiktok/updatePixelEvent":{"post":{"summary":"Prepare tiktok updatePixelEvent (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"currency":{"type":"string","maxLength":100000},"currency_value":{"type":"string","maxLength":100000},"event_id":{"type":"string","maxLength":100000},"event_name":{"type":"string","maxLength":100000}},"required":["event_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_updatePixelEvent"}},"/accounts/{accountId}/native/tiktok/deletePixelEvent":{"post":{"summary":"Prepare tiktok deletePixelEvent (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"event_id":{"type":"string","maxLength":100000}},"required":["event_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_deletePixelEvent"}},"/accounts/{accountId}/native/tiktok/getPixelEventStats":{"post":{"summary":"Read tiktok getPixelEventStats (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"pixel_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"date_range":{"type":"object","properties":{"end_date":{"type":"string","maxLength":100000},"start_date":{"type":"string","maxLength":100000}},"required":["end_date","start_date"],"additionalProperties":false}},"required":["pixel_ids","date_range"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_getPixelEventStats"}},"/accounts/{accountId}/native/tiktok/listOfflineEventSets":{"post":{"summary":"Read tiktok listOfflineEventSets (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"event_set_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"name":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listOfflineEventSets"}},"/accounts/{accountId}/native/tiktok/createOfflineEventSet":{"post":{"summary":"Prepare tiktok createOfflineEventSet (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"auto_tracking":{"type":"boolean"},"description":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000}},"required":["description","name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createOfflineEventSet"}},"/accounts/{accountId}/native/tiktok/updateOfflineEventSet":{"post":{"summary":"Prepare tiktok updateOfflineEventSet (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"auto_tracking":{"type":"boolean"},"event_set_id":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000}},"required":["event_set_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_updateOfflineEventSet"}},"/accounts/{accountId}/native/tiktok/deleteOfflineEventSet":{"post":{"summary":"Prepare tiktok deleteOfflineEventSet (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"event_set_id":{"type":"string","maxLength":100000}},"required":["event_set_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_deleteOfflineEventSet"}},"/accounts/{accountId}/native/tiktok/createIdentity":{"post":{"summary":"Prepare tiktok createIdentity (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"display_name":{"type":"string","maxLength":100000},"image_uri":{"type":"string","maxLength":100000}},"required":["display_name","image_uri"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createIdentity"}},"/accounts/{accountId}/native/tiktok/listIdentities":{"post":{"summary":"Read tiktok listIdentities (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"identity_type":{"type":"string","maxLength":100000},"identity_authorized_bc_id":{"type":"string","maxLength":100000},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listIdentities"}},"/accounts/{accountId}/native/tiktok/getIdentityVideo":{"post":{"summary":"Read tiktok getIdentityVideo (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"identity_type":{"type":"string","maxLength":100000},"identity_id":{"type":"string","maxLength":100000},"item_id":{"type":"string","maxLength":100000},"identity_authorized_bc_id":{"type":"string","maxLength":100000}},"required":["identity_type","identity_id","item_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_getIdentityVideo"}},"/accounts/{accountId}/native/tiktok/listAdComments":{"post":{"summary":"Read tiktok listAdComments (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"start_time":{"type":"string","maxLength":100000},"end_time":{"type":"string","maxLength":100000},"search_field":{"type":"string","maxLength":100000},"search_value":{"type":"string","maxLength":100000},"sort_field":{"type":"string","maxLength":100000},"sort_type":{"type":"string","maxLength":100000},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000},"comment_type":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"comment_status":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["start_time","end_time","search_field","search_value"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listAdComments"}},"/accounts/{accountId}/native/tiktok/queryInsights":{"post":{"summary":"Read tiktok queryInsights (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"report_type":{"type":"string","maxLength":100000},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000},"enable_total_metrics":{"type":"boolean"},"multi_adv_report_in_utc_time":{"type":"boolean"},"service_type":{"type":"string","maxLength":100000},"data_level":{"type":"string","maxLength":100000},"dimensions":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"metrics":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"start_date":{"type":"string","format":"date","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])))$"},"end_date":{"type":"string","format":"date","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])))$"},"query_lifetime":{"type":"boolean"},"order_field":{"type":"string","maxLength":100000},"order_type":{"type":"string","maxLength":100000},"filtering":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["report_type"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_queryInsights"}},"/accounts/{accountId}/native/tiktok/replyToComment":{"post":{"summary":"Prepare tiktok replyToComment (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"ad_id":{"type":"string","maxLength":100000},"tiktok_item_id":{"type":"string","maxLength":100000},"comment_id":{"type":"string","maxLength":100000},"comment_type":{"type":"string","enum":["REPLY","COMMENT"]},"identity_id":{"type":"string","maxLength":100000},"identity_type":{"type":"string","enum":["CUSTOMIZED_USER","TT_USER","BC_AUTH_TT","AUTH_CODE"]},"text":{"type":"string","maxLength":100000}},"required":["ad_id","comment_id","identity_id","identity_type","text"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_replyToComment"}},"/accounts/{accountId}/native/tiktok/setCommentVisibility":{"post":{"summary":"Prepare tiktok setCommentVisibility (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"comment_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"operation":{"type":"string","enum":["HIDDEN","PUBLIC"]}},"required":["comment_ids","operation"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_setCommentVisibility"}},"/accounts/{accountId}/native/tiktok/deleteComment":{"post":{"summary":"Prepare tiktok deleteComment (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"ad_id":{"type":"string","maxLength":100000},"tiktok_item_id":{"type":"string","maxLength":100000},"comment_id":{"type":"string","maxLength":100000},"identity_id":{"type":"string","maxLength":100000},"identity_type":{"type":"string","enum":["CUSTOMIZED_USER","TT_USER","BC_AUTH_TT","AUTH_CODE"]}},"required":["comment_id","identity_id","identity_type"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_deleteComment"}},"/accounts/{accountId}/native/tiktok/createLeadDownload":{"post":{"summary":"Prepare tiktok createLeadDownload (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"page_id":{"type":"string","maxLength":100000},"ad_id":{"type":"string","maxLength":100000},"task_id":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createLeadDownload"}},"/accounts/{accountId}/native/tiktok/downloadLeads":{"post":{"summary":"Read tiktok downloadLeads (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"task_id":{"type":"string","maxLength":100000}},"required":["task_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_downloadLeads"}},"/accounts/{accountId}/native/tiktok/listInstantForms":{"post":{"summary":"Read tiktok listInstantForms (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"business_type":{"type":"string","enum":["LEAD_GEN","TIKTOK_INSTANT_PAGE","STORE_FRONT","APP_PROFILE_PAGE"]},"status":{"type":"string","enum":["PUBLISHED","EDITED"]},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listInstantForms"}},"/accounts/{accountId}/native/tiktok/createInteractiveAddOn":{"post":{"summary":"Prepare tiktok createInteractiveAddOn (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"creative_portfolio_type":{"type":"string","enum":["CARD","STICKER","WEB_INFO_CARD","DOWNLOAD_CARD","GESTURE","PREMIUM_BADGE"]},"portfolio_content":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["creative_portfolio_type","portfolio_content"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createInteractiveAddOn"}},"/accounts/{accountId}/native/tiktok/listInteractiveAddOns":{"post":{"summary":"Read tiktok listInteractiveAddOns (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listInteractiveAddOns"}},"/accounts/{accountId}/native/tiktok/previewAd":{"post":{"summary":"Prepare tiktok previewAd (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"preview_type":{"type":"string","enum":["AD"]},"ad_id":{"type":"string","maxLength":100000},"language":{"type":"string","enum":["ENGLISH","CHINESE","JAPANESE"]}},"required":["preview_type","ad_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_previewAd"}},"/accounts/{accountId}/native/tiktok/listCatalogs":{"post":{"summary":"Read tiktok listCatalogs (bc)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listCatalogs"}},"/accounts/{accountId}/native/tiktok/createCatalog":{"post":{"summary":"Prepare tiktok createCatalog (bc)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"catalog_type":{"type":"string","enum":["ECOM","HOTEL","FLIGHT","DESTINATION","ENTERTAINMENT","MINI_SERIES","AUTO_MODEL","AUTO_INVENTORY"]},"catalog_conf":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["name","catalog_type","catalog_conf"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_createCatalog"}},"/accounts/{accountId}/native/tiktok/renameCatalog":{"post":{"summary":"Prepare tiktok renameCatalog (bc)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000}},"required":["catalog_id","name"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_renameCatalog"}},"/accounts/{accountId}/native/tiktok/deleteCatalog":{"post":{"summary":"Prepare tiktok deleteCatalog (bc)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000}},"required":["catalog_id"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_tiktok_deleteCatalog"}},"/accounts/{accountId}/native/tiktok/catalogOverview":{"post":{"summary":"Read tiktok catalogOverview (bc)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000}},"required":["catalog_id"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_catalogOverview"}},"/accounts/{accountId}/native/tiktok/listProductSets":{"post":{"summary":"Read tiktok listProductSets (bc)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000},"product_set_id":{"type":"string","maxLength":100000},"return_product_count":{"type":"boolean"}},"required":["catalog_id"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_tiktok_listProductSets"}},"/accounts/{accountId}/native/linkedin/listConversions":{"post":{"summary":"Read linkedin listConversions (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"count":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_listConversions"}},"/accounts/{accountId}/native/linkedin/createConversion":{"post":{"summary":"Prepare linkedin createConversion (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"type":{"type":"string","enum":["ADD_TO_CART","DOWNLOAD","INSTALL","KEY_PAGE_VIEW","LEAD","PURCHASE","SIGN_UP","OTHER","SAVE","START_CHECKOUT","SCHEDULE","VIEW_CONTENT","VIEW_VIDEO","ADD_BILLING_INFO","BOOK_APPOINTMENT","REQUEST_QUOTE","SEARCH","SUBSCRIBE","AD_CLICK","AD_VIEW","COMPLETE_SIGNUP","SUBMIT_APPLICATION","PHONE_CALL","INVITE","LOGIN","SHARE","DONATE","ADD_TO_LIST","START_TRIAL","OUTBOUND_CLICK","CONTACT","QUALIFIED_LEAD","MARKETING_QUALIFIED_LEAD","SALES_QUALIFIED_LEAD"]},"enabled":{"type":"boolean"},"postClickAttributionWindowSize":{"anyOf":[{"type":"number","const":1},{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90},{"type":"number","const":365}]},"viewThroughAttributionWindowSize":{"anyOf":[{"type":"number","const":1},{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90},{"type":"number","const":365}]},"attributionType":{"type":"string","enum":["LAST_TOUCH_BY_CAMPAIGN","LAST_TOUCH_BY_CONVERSION"]},"valueType":{"type":"string","enum":["DYNAMIC","FIXED","NO_VALUE"]},"value":{"type":"object","properties":{"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false},"conversionMethod":{"type":"string","enum":["CONVERSIONS_API","INSIGHT_TAG"]},"autoAssociationType":{"type":"string","enum":["ALL_CAMPAIGNS","OBJECTIVE_BASED"]}},"required":["name","type","conversionMethod"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_createConversion"}},"/accounts/{accountId}/native/linkedin/getConversion":{"post":{"summary":"Read linkedin getConversion (conversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_getConversion"}},"/accounts/{accountId}/native/linkedin/updateConversion":{"post":{"summary":"Prepare linkedin updateConversion (conversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"type":{"type":"string","enum":["ADD_TO_CART","DOWNLOAD","INSTALL","KEY_PAGE_VIEW","LEAD","PURCHASE","SIGN_UP","OTHER","SAVE","START_CHECKOUT","SCHEDULE","VIEW_CONTENT","VIEW_VIDEO","ADD_BILLING_INFO","BOOK_APPOINTMENT","REQUEST_QUOTE","SEARCH","SUBSCRIBE","AD_CLICK","AD_VIEW","COMPLETE_SIGNUP","SUBMIT_APPLICATION","PHONE_CALL","INVITE","LOGIN","SHARE","DONATE","ADD_TO_LIST","START_TRIAL","OUTBOUND_CLICK","CONTACT","QUALIFIED_LEAD","MARKETING_QUALIFIED_LEAD","SALES_QUALIFIED_LEAD"]},"enabled":{"type":"boolean"},"postClickAttributionWindowSize":{"anyOf":[{"type":"number","const":1},{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90},{"type":"number","const":365}]},"viewThroughAttributionWindowSize":{"anyOf":[{"type":"number","const":1},{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90},{"type":"number","const":365}]},"attributionType":{"type":"string","enum":["LAST_TOUCH_BY_CAMPAIGN","LAST_TOUCH_BY_CONVERSION"]},"valueType":{"type":"string","enum":["DYNAMIC","FIXED","NO_VALUE"]},"value":{"type":"object","properties":{"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_updateConversion"}},"/accounts/{accountId}/native/linkedin/deleteConversion":{"post":{"summary":"Prepare linkedin deleteConversion (conversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_deleteConversion"}},"/accounts/{accountId}/native/linkedin/listCampaignConversions":{"post":{"summary":"Read linkedin listCampaignConversions (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"count":{"type":"integer","minimum":1,"maximum":1000}},"required":["campaignId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_listCampaignConversions"}},"/accounts/{accountId}/native/linkedin/addCampaignConversion":{"post":{"summary":"Prepare linkedin addCampaignConversion (conversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["campaignId"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_addCampaignConversion"}},"/accounts/{accountId}/native/linkedin/removeCampaignConversion":{"post":{"summary":"Prepare linkedin removeCampaignConversion (conversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["campaignId"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_removeCampaignConversion"}},"/accounts/{accountId}/native/linkedin/sendConversionEvents":{"post":{"summary":"Prepare linkedin sendConversionEvents (conversion)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"elements":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"conversionHappenedAt":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"conversionValue":{"type":"object","properties":{"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false},"eventId":{"type":"string","minLength":1,"maxLength":255},"user":{"type":"object","properties":{"userIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"idType":{"type":"string","enum":["SHA256_EMAIL","LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID","PLAINTEXT_IP_ADDRESS","GOOGLE_AID","ACXIOM_ID","SHA256_IP_ADDRESS"]},"idValue":{"type":"string","minLength":1,"maxLength":1000}},"required":["idType","idValue"],"additionalProperties":false}},"userInfo":{"type":"object","properties":{"firstName":{"type":"string","minLength":1,"maxLength":255},"lastName":{"type":"string","minLength":1,"maxLength":255},"title":{"type":"string","minLength":1,"maxLength":255},"companyName":{"type":"string","minLength":1,"maxLength":255},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["firstName","lastName"],"additionalProperties":false},"lead":{"type":"string","pattern":"^urn:li:leadGenFormResponse:[A-Za-z0-9_-]+$"},"externalIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":255}}},"additionalProperties":false}},"required":["conversionHappenedAt","user"],"additionalProperties":false}}},"required":["elements"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_sendConversionEvents"}},"/accounts/{accountId}/native/linkedin/listAudiences":{"post":{"summary":"Read linkedin listAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"count":{"type":"integer","minimum":1,"maximum":1000},"sourcePlatform":{"type":"string","maxLength":100000},"sourceSegmentId":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_listAudiences"}},"/accounts/{accountId}/native/linkedin/createAudience":{"post":{"summary":"Prepare linkedin createAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"description":{"type":"string","maxLength":100000},"sourcePlatform":{"type":"string","maxLength":100000},"sourceSegmentId":{"type":"string","maxLength":100000},"type":{"type":"string","enum":["USER","COMPANY","LIST_UPLOAD"]},"destinations":{"maxItems":10000,"type":"array","items":{"type":"object","properties":{"destination":{"type":"string","const":"LINKEDIN"}},"required":["destination"],"additionalProperties":false}}},"required":["name","sourcePlatform","type"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_createAudience"}},"/accounts/{accountId}/native/linkedin/getAudience":{"post":{"summary":"Read linkedin getAudience (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_getAudience"}},"/accounts/{accountId}/native/linkedin/updateAudience":{"post":{"summary":"Prepare linkedin updateAudience (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"description":{"type":"string","maxLength":100000},"sourceSegmentId":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_updateAudience"}},"/accounts/{accountId}/native/linkedin/deleteAudience":{"post":{"summary":"Prepare linkedin deleteAudience (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_deleteAudience"}},"/accounts/{accountId}/native/linkedin/changeAudienceUsers":{"post":{"summary":"Prepare linkedin changeAudienceUsers (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"elements":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["ADD","REMOVE"]},"userIds":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"idType":{"type":"string","enum":["SHA256_EMAIL","SHA512_EMAIL","GOOGLE_AID"]},"idValue":{"type":"string","minLength":1,"maxLength":128}},"required":["idType","idValue"],"additionalProperties":false}},"firstName":{"type":"string","minLength":1,"maxLength":255},"lastName":{"type":"string","minLength":1,"maxLength":255},"title":{"type":"string","minLength":1,"maxLength":255},"company":{"type":"string","minLength":1,"maxLength":255},"country":{"type":"string","minLength":1,"maxLength":255}},"required":["action"],"additionalProperties":false}}},"required":["elements"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_changeAudienceUsers"}},"/accounts/{accountId}/native/linkedin/changeAudienceCompanies":{"post":{"summary":"Prepare linkedin changeAudienceCompanies (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"elements":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"action":{"type":"string","enum":["ADD","REMOVE"]},"companyName":{"type":"string","minLength":1,"maxLength":255},"companyWebsiteDomain":{"type":"string","minLength":1,"maxLength":255},"companyPageUrl":{"type":"string","minLength":1,"maxLength":255},"stockSymbol":{"type":"string","minLength":1,"maxLength":255},"industries":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":255}},"city":{"type":"string","minLength":1,"maxLength":255},"state":{"type":"string","minLength":1,"maxLength":255},"country":{"type":"string","minLength":1,"maxLength":255}},"required":["action"],"additionalProperties":false}}},"required":["elements"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_changeAudienceCompanies"}},"/accounts/{accountId}/native/linkedin/createCompanyList":{"post":{"summary":"Prepare linkedin createCompanyList (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"description":{"type":"string","maxLength":100000}},"required":["name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_createCompanyList"}},"/accounts/{accountId}/native/linkedin/addCompanies":{"post":{"summary":"Prepare linkedin addCompanies (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"companies":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["companies"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_addCompanies"}},"/accounts/{accountId}/native/linkedin/removeCompanies":{"post":{"summary":"Prepare linkedin removeCompanies (audience)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entityId":{"type":"string","maxLength":100,"pattern":"^\\d+$"},"params":{"type":"object","properties":{"companies":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["companies"],"additionalProperties":false}},"required":["entityId","params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_removeCompanies"}},"/accounts/{accountId}/native/linkedin/createPredictiveAudience":{"post":{"summary":"Prepare linkedin createPredictiveAudience (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"seeds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"locations":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"desiredAudienceCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["name","seeds","locations"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_createPredictiveAudience"}},"/accounts/{accountId}/native/linkedin/saveAudienceTemplate":{"post":{"summary":"Prepare linkedin saveAudienceTemplate (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"name":{"type":"string","maxLength":100000},"description":{"type":"string","maxLength":100000}},"required":["campaignId","name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_saveAudienceTemplate"}},"/accounts/{accountId}/native/linkedin/listAudienceTemplates":{"post":{"summary":"Read linkedin listAudienceTemplates (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"count":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_listAudienceTemplates"}},"/accounts/{accountId}/native/linkedin/uploadDocument":{"post":{"summary":"Prepare linkedin uploadDocument (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"url":{"type":"string","maxLength":100000},"page":{"type":"string","maxLength":100000}},"required":["url"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_uploadDocument"}},"/accounts/{accountId}/native/linkedin/getBidPricing":{"post":{"summary":"Read linkedin getBidPricing (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignType":{"type":"string","enum":["TEXT_AD","SPONSORED_UPDATES","SPONSORED_INMAILS"]},"bidType":{"type":"string","enum":["CPM","CPC","CPV"]},"matchType":{"type":"string","enum":["EXACT","AUDIENCE_EXPANDED"]},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"targetingCriteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"optimizationTargetType":{"type":"string","maxLength":100000},"objectiveType":{"type":"string","maxLength":100000},"dailyBudget":{"type":"object","properties":{"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["campaignType","bidType","matchType","currency","targetingCriteria"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_getBidPricing"}},"/accounts/{accountId}/native/linkedin/getSupplyForecast":{"post":{"summary":"Read linkedin getSupplyForecast (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignType":{"type":"string","enum":["TEXT_AD","SPONSORED_UPDATES","SPONSORED_INMAILS"]},"targetingCriteria":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"timeRange":{"type":"object","properties":{"start":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"end":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["start","end"],"additionalProperties":false},"dailyBudget":{"type":"object","properties":{"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false},"totalBudget":{"type":"object","properties":{"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false},"competingBid":{"type":"object","properties":{"bidType":{"type":"string","enum":["CPM","CPC","CPV"]},"bidPrice":{"type":"object","properties":{"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["currencyCode","amount"],"additionalProperties":false}},"required":["bidType","bidPrice"],"additionalProperties":false},"optimizationTarget":{"type":"string","maxLength":100000},"objectiveType":{"type":"string","maxLength":100000},"creativeType":{"type":"string","maxLength":100000},"enableAudienceNetwork":{"type":"boolean"},"enableAudienceExpansion":{"type":"boolean"},"connectedTelevisionOnly":{"type":"boolean"},"targetCost":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"costCap":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"}},"required":["campaignType","targetingCriteria","timeRange"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_getSupplyForecast"}},"/accounts/{accountId}/native/linkedin/listLeadForms":{"post":{"summary":"Read linkedin listLeadForms (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"count":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_listLeadForms"}},"/accounts/{accountId}/native/linkedin/createLeadForm":{"post":{"summary":"Prepare linkedin createLeadForm (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"headline":{"type":"string","maxLength":100000},"description":{"type":"string","maxLength":100000},"fields":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["FIRST_NAME","LAST_NAME","EMAIL","WORK_EMAIL","PHONE_NUMBER","WORK_PHONE_NUMBER","CITY","STATE","COUNTRY","ZIP_CODE","JOB_TITLE","JOB_FUNCTION","SENIORITY","COMPANY_NAME","COMPANY_SIZE","INDUSTRY","DEGREE","FIELD_OF_STUDY","SCHOOL","START_DATE","GRADUATION_DATE","GENDER","LINKEDIN_PROFILE_LINK"]}},"customQuestions":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"privacyPolicyUrl":{"type":"string","maxLength":100000},"legalDisclaimer":{"type":"string","maxLength":100000},"consent":{"type":"string","maxLength":100000},"thankYouMessage":{"type":"string","maxLength":100000},"landingPageUrl":{"type":"string","maxLength":100000},"language":{"type":"string","enum":["en_US","en_GB","fr_FR","de_DE","es_ES","it_IT","pt_BR","nl_NL","ja_JP","zh_CN"]}},"required":["name","headline","fields","privacyPolicyUrl"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_linkedin_createLeadForm"}},"/accounts/{accountId}/native/linkedin/listLeads":{"post":{"summary":"Read linkedin listLeads (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"formId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"submittedAfter":{"type":"string","format":"date","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])))$"},"submittedBefore":{"type":"string","format":"date","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])))$"},"testLeadsOnly":{"type":"boolean"},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"count":{"type":"integer","minimum":1,"maximum":1000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_listLeads"}},"/accounts/{accountId}/native/linkedin/getRevenueAttribution":{"post":{"summary":"Read linkedin getRevenueAttribution (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"groupBy":{"type":"string","enum":["CAMPAIGN","CAMPAIGN_GROUP","ACCOUNT"]},"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["groupBy","startDate","endDate"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_linkedin_getRevenueAttribution"}},"/accounts/{accountId}/native/chatgpt/createPixel":{"post":{"summary":"Prepare chatgpt createPixel (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000}},"required":["name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_createPixel"}},"/accounts/{accountId}/native/chatgpt/checkPixelEvents":{"post":{"summary":"Read chatgpt checkPixelEvents (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"pixelId":{"type":"string","maxLength":100000}},"required":["pixelId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_chatgpt_checkPixelEvents"}},"/accounts/{accountId}/native/chatgpt/listConversionEventSettings":{"post":{"summary":"Read chatgpt listConversionEventSettings (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_chatgpt_listConversionEventSettings"}},"/accounts/{accountId}/native/chatgpt/createConversionEventSetting":{"post":{"summary":"Prepare chatgpt createConversionEventSetting (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"eventType":{"type":"string","enum":["page_viewed","contents_viewed","items_added","checkout_started","order_created","lead_created","registration_completed","appointment_scheduled","subscription_created","trial_started","app_installed","app_opened","custom"]},"customEventName":{"type":"string","maxLength":100000},"sourceId":{"type":"string","maxLength":100000}},"required":["name","eventType","sourceId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_createConversionEventSetting"}},"/accounts/{accountId}/native/chatgpt/updateBrand":{"post":{"summary":"Prepare chatgpt updateBrand (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"faviconUrl":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_updateBrand"}},"/accounts/{accountId}/native/chatgpt/listSpendLimits":{"post":{"summary":"Read chatgpt listSpendLimits (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_chatgpt_listSpendLimits"}},"/accounts/{accountId}/native/chatgpt/createSpendLimitWindow":{"post":{"summary":"Prepare chatgpt createSpendLimitWindow (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"},"amount":{"type":"number"},"name":{"type":"string","maxLength":100000}},"required":["startDate","endDate","amount"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_createSpendLimitWindow"}},"/accounts/{accountId}/native/chatgpt/updateSpendLimitWindow":{"post":{"summary":"Prepare chatgpt updateSpendLimitWindow (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"windowId":{"type":"string","maxLength":100000},"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"},"amount":{"type":"number"},"name":{"type":"string","maxLength":100000}},"required":["windowId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_updateSpendLimitWindow"}},"/accounts/{accountId}/native/chatgpt/deleteSpendLimitWindow":{"post":{"summary":"Prepare chatgpt deleteSpendLimitWindow (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"windowId":{"type":"string","maxLength":100000}},"required":["windowId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_deleteSpendLimitWindow"}},"/accounts/{accountId}/native/chatgpt/setDailySpendLimit":{"post":{"summary":"Prepare chatgpt setDailySpendLimit (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"amount":{"type":"number"},"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["amount"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_setDailySpendLimit"}},"/accounts/{accountId}/native/chatgpt/removeDailySpendLimit":{"post":{"summary":"Prepare chatgpt removeDailySpendLimit (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_removeDailySpendLimit"}},"/accounts/{accountId}/native/chatgpt/previewAd":{"post":{"summary":"Read chatgpt previewAd (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adId":{"type":"string","maxLength":100000}},"required":["adId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_chatgpt_previewAd"}},"/accounts/{accountId}/native/chatgpt/listFeeds":{"post":{"summary":"Read chatgpt listFeeds (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_chatgpt_listFeeds"}},"/accounts/{accountId}/native/chatgpt/createFeed":{"post":{"summary":"Prepare chatgpt createFeed (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"countries":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["name","countries"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_createFeed"}},"/accounts/{accountId}/native/chatgpt/listFeedUploads":{"post":{"summary":"Read chatgpt listFeedUploads (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_chatgpt_listFeedUploads"}},"/accounts/{accountId}/native/chatgpt/queryFeedProducts":{"post":{"summary":"Read chatgpt queryFeedProducts (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"feedId":{"type":"string","maxLength":100000},"filters":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"limit":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["feedId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_chatgpt_queryFeedProducts"}},"/accounts/{accountId}/native/chatgpt/updateFeedProducts":{"post":{"summary":"Prepare chatgpt updateFeedProducts (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"feedId":{"type":"string","maxLength":100000},"products":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["feedId","products"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_updateFeedProducts"}},"/accounts/{accountId}/native/chatgpt/archiveFeed":{"post":{"summary":"Prepare chatgpt archiveFeed (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"feedId":{"type":"string","maxLength":100000}},"required":["feedId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_archiveFeed"}},"/accounts/{accountId}/native/chatgpt/mergeAudiences":{"post":{"summary":"Prepare chatgpt mergeAudiences (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"audienceIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["name","audienceIds"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_chatgpt_mergeAudiences"}},"/accounts/{accountId}/native/x/listLeadForms":{"post":{"summary":"Read x listLeadForms (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"with_deleted":{"type":"boolean"}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_listLeadForms"}},"/accounts/{accountId}/native/x/createLeadForm":{"post":{"summary":"Prepare x createLeadForm (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"purpose":{"type":"string","maxLength":100000},"fields":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["EMAIL","PHONE_NUMBER","STREET_ADDRESS","CITY","STATE","COUNTRY","ZIP_CODE","FULL_NAME","FIRST_NAME","LAST_NAME","DATE_OF_BIRTH","COMPANY_NAME","JOB_TITLE","WORK_EMAIL","WORK_PHONE_NUMBER","GENDER","HANDLE"]}},"optional_fields":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["EMAIL","PHONE_NUMBER","STREET_ADDRESS","CITY","STATE","COUNTRY","ZIP_CODE","FULL_NAME","FIRST_NAME","LAST_NAME","DATE_OF_BIRTH","COMPANY_NAME","JOB_TITLE","WORK_EMAIL","WORK_PHONE_NUMBER","GENDER","HANDLE"]}},"privacy_policy_url":{"type":"string","maxLength":100000},"company_name":{"type":"string","maxLength":100000},"intro_headline":{"type":"string","maxLength":100000},"intro_description":{"type":"string","maxLength":100000},"thanks_headline":{"type":"string","maxLength":100000},"thanks_description":{"type":"string","maxLength":100000},"thanks_button_url":{"type":"string","maxLength":100000},"thanks_button_title":{"type":"string","maxLength":100000}},"required":["name","purpose","fields","privacy_policy_url","company_name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_createLeadForm"}},"/accounts/{accountId}/native/x/updateLeadForm":{"post":{"summary":"Prepare x updateLeadForm (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"lead_form_id":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000},"purpose":{"type":"string","maxLength":100000},"fields":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["EMAIL","PHONE_NUMBER","STREET_ADDRESS","CITY","STATE","COUNTRY","ZIP_CODE","FULL_NAME","FIRST_NAME","LAST_NAME","DATE_OF_BIRTH","COMPANY_NAME","JOB_TITLE","WORK_EMAIL","WORK_PHONE_NUMBER","GENDER","HANDLE"]}},"optional_fields":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["EMAIL","PHONE_NUMBER","STREET_ADDRESS","CITY","STATE","COUNTRY","ZIP_CODE","FULL_NAME","FIRST_NAME","LAST_NAME","DATE_OF_BIRTH","COMPANY_NAME","JOB_TITLE","WORK_EMAIL","WORK_PHONE_NUMBER","GENDER","HANDLE"]}},"privacy_policy_url":{"type":"string","maxLength":100000},"company_name":{"type":"string","maxLength":100000},"intro_headline":{"type":"string","maxLength":100000},"intro_description":{"type":"string","maxLength":100000},"thanks_headline":{"type":"string","maxLength":100000},"thanks_description":{"type":"string","maxLength":100000},"thanks_button_url":{"type":"string","maxLength":100000},"thanks_button_title":{"type":"string","maxLength":100000}},"required":["lead_form_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_updateLeadForm"}},"/accounts/{accountId}/native/x/archiveLeadForm":{"post":{"summary":"Prepare x archiveLeadForm (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"lead_form_id":{"type":"string","maxLength":100000}},"required":["lead_form_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_archiveLeadForm"}},"/accounts/{accountId}/native/x/exportLeads":{"post":{"summary":"Prepare x exportLeads (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"lead_form_id":{"type":"string","maxLength":100000},"start_date":{"type":"string","format":"date","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])))$"},"end_date":{"type":"string","format":"date","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])))$"},"response_format":{"type":"string","enum":["csv","json","xlsx"]}},"required":["lead_form_id","start_date","end_date"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_exportLeads"}},"/accounts/{accountId}/native/x/getLeadExport":{"post":{"summary":"Read x getLeadExport (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"export_id":{"type":"string","maxLength":100000}},"required":["export_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_getLeadExport"}},"/accounts/{accountId}/native/x/cancelLeadExport":{"post":{"summary":"Prepare x cancelLeadExport (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"export_id":{"type":"string","maxLength":100000}},"required":["export_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_cancelLeadExport"}},"/accounts/{accountId}/native/x/sendConversionEvents":{"post":{"summary":"Prepare x sendConversionEvents (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"pixel_id":{"type":"string","maxLength":100000},"conversions":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["pixel_id","conversions"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_sendConversionEvents"}},"/accounts/{accountId}/native/x/campaignReach":{"post":{"summary":"Read x campaignReach (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaign_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"start_date":{"type":"string","format":"date","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])))$"},"end_date":{"type":"string","format":"date","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])))$"}},"required":["campaign_ids","start_date","end_date"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_campaignReach"}},"/accounts/{accountId}/native/x/getPromotedPost":{"post":{"summary":"Read x getPromotedPost (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"promoted_tweet_id":{"type":"string","maxLength":100000},"with_deleted":{"type":"boolean"}},"required":["promoted_tweet_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_getPromotedPost"}},"/accounts/{accountId}/native/x/previewPromotedPost":{"post":{"summary":"Read x previewPromotedPost (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"promoted_tweet_id":{"type":"string","maxLength":100000}},"required":["promoted_tweet_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_previewPromotedPost"}},"/accounts/{accountId}/native/x/suggestTargeting":{"post":{"summary":"Read x suggestTargeting (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"suggestion_type":{"type":"string","enum":["KEYWORD","USER_ID"]},"targeting_values":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["suggestion_type","targeting_values"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_suggestTargeting"}},"/accounts/{accountId}/native/x/listScheduledPosts":{"post":{"summary":"Read x listScheduledPosts (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_listScheduledPosts"}},"/accounts/{accountId}/native/x/createScheduledPost":{"post":{"summary":"Prepare x createScheduledPost (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"scheduled_at":{"type":"string","maxLength":100000},"as_user_id":{"type":"string","maxLength":100000},"text":{"type":"string","maxLength":100000},"card_uri":{"type":"string","maxLength":100000},"media_keys":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["scheduled_at","as_user_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_createScheduledPost"}},"/accounts/{accountId}/native/x/deleteScheduledPost":{"post":{"summary":"Prepare x deleteScheduledPost (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"scheduled_tweet_id":{"type":"string","maxLength":100000}},"required":["scheduled_tweet_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_deleteScheduledPost"}},"/accounts/{accountId}/native/x/promoteScheduledPost":{"post":{"summary":"Prepare x promoteScheduledPost (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"line_item_id":{"type":"string","maxLength":100000},"scheduled_tweet_id":{"type":"string","maxLength":100000}},"required":["line_item_id","scheduled_tweet_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_promoteScheduledPost"}},"/accounts/{accountId}/native/x/listScheduledPromotedPosts":{"post":{"summary":"Read x listScheduledPromotedPosts (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"line_item_ids":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_listScheduledPromotedPosts"}},"/accounts/{accountId}/native/x/listDraftPosts":{"post":{"summary":"Read x listDraftPosts (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_listDraftPosts"}},"/accounts/{accountId}/native/x/createDraftPost":{"post":{"summary":"Prepare x createDraftPost (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"as_user_id":{"type":"string","maxLength":100000},"text":{"type":"string","maxLength":100000},"card_uri":{"type":"string","maxLength":100000},"media_keys":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["as_user_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_createDraftPost"}},"/accounts/{accountId}/native/x/updateDraftPost":{"post":{"summary":"Prepare x updateDraftPost (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"draft_tweet_id":{"type":"string","maxLength":100000},"text":{"type":"string","maxLength":100000},"card_uri":{"type":"string","maxLength":100000},"media_keys":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["draft_tweet_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_updateDraftPost"}},"/accounts/{accountId}/native/x/deleteDraftPost":{"post":{"summary":"Prepare x deleteDraftPost (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"draft_tweet_id":{"type":"string","maxLength":100000}},"required":["draft_tweet_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_deleteDraftPost"}},"/accounts/{accountId}/native/x/createPollCard":{"post":{"summary":"Prepare x createPollCard (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"duration_in_minutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_choice":{"type":"string","maxLength":100000},"second_choice":{"type":"string","maxLength":100000},"third_choice":{"type":"string","maxLength":100000},"fourth_choice":{"type":"string","maxLength":100000},"media_key":{"type":"string","maxLength":100000}},"required":["name","duration_in_minutes","first_choice","second_choice"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_createPollCard"}},"/accounts/{accountId}/native/x/createConversationCard":{"post":{"summary":"Prepare x createConversationCard (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"media_type":{"type":"string","enum":["image","video"]},"name":{"type":"string","maxLength":100000},"media_key":{"type":"string","maxLength":100000},"title":{"type":"string","maxLength":100000},"first_cta":{"type":"string","maxLength":100000},"first_cta_tweet":{"type":"string","maxLength":100000},"second_cta":{"type":"string","maxLength":100000},"second_cta_tweet":{"type":"string","maxLength":100000},"third_cta":{"type":"string","maxLength":100000},"third_cta_tweet":{"type":"string","maxLength":100000},"fourth_cta":{"type":"string","maxLength":100000},"fourth_cta_tweet":{"type":"string","maxLength":100000},"thank_you_text":{"type":"string","maxLength":100000},"thank_you_url":{"type":"string","maxLength":100000}},"required":["media_type","name","media_key","first_cta","first_cta_tweet","thank_you_text"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_createConversationCard"}},"/accounts/{accountId}/native/x/listCatalogs":{"post":{"summary":"Read x listCatalogs (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_listCatalogs"}},"/accounts/{accountId}/native/x/createCatalog":{"post":{"summary":"Prepare x createCatalog (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000}},"required":["name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_createCatalog"}},"/accounts/{accountId}/native/x/renameCatalog":{"post":{"summary":"Prepare x renameCatalog (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"product_catalog_id":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000}},"required":["product_catalog_id","name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_renameCatalog"}},"/accounts/{accountId}/native/x/deleteCatalog":{"post":{"summary":"Prepare x deleteCatalog (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"product_catalog_id":{"type":"string","maxLength":100000}},"required":["product_catalog_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_deleteCatalog"}},"/accounts/{accountId}/native/x/listCatalogProducts":{"post":{"summary":"Read x listCatalogProducts (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"product_catalog_id":{"type":"string","maxLength":100000}},"required":["product_catalog_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_x_listCatalogProducts"}},"/accounts/{accountId}/native/x/upsertCatalogProducts":{"post":{"summary":"Prepare x upsertCatalogProducts (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"product_catalog_id":{"type":"string","maxLength":100000},"products":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["product_catalog_id","products"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_upsertCatalogProducts"}},"/accounts/{accountId}/native/x/createCatalogFeed":{"post":{"summary":"Prepare x createCatalogFeed (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"product_catalog_id":{"type":"string","maxLength":100000},"feed_url":{"type":"string","maxLength":100000},"feed_format":{"type":"string","enum":["CSV","TSV","XML"]},"frequency":{"type":"string","enum":["HOURLY","DAILY","WEEKLY"]},"start_time":{"type":"string","maxLength":100000}},"required":["product_catalog_id","feed_url","feed_format","frequency","start_time"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_x_createCatalogFeed"}},"/accounts/{accountId}/native/outbrain/listConversionEvents":{"post":{"summary":"Read outbrain listConversionEvents (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_outbrain_listConversionEvents"}},"/accounts/{accountId}/native/outbrain/createConversionEvent":{"post":{"summary":"Prepare outbrain createConversionEvent (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"type":{"type":"string","enum":["URL_BASED","EVENT_BASED","ENGAGEMENT"]},"name":{"type":"string","maxLength":100000},"url":{"type":"string","maxLength":100000},"category":{"type":"string","enum":["PURCHASE","CHECKOUT","ADD_TO_CART","LEAD","REGISTRATION","EMAIL_SIGN_UP","CONTENT_VIEW","VIDEO_VIEW","DOWNLOAD","SEARCH","OTHER","TIME_ON_PAGE","MOUSE_CLICK","SCROLL_DEPTH"]},"conversionWindow":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"includeInConversions":{"type":"boolean"},"enabled":{"type":"boolean"},"orderValue":{"type":"number"},"orderCurrency":{"type":"string","maxLength":100000},"timeOnPageSettingValue":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scrollDepthSettingValue":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["type","name","category"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_outbrain_createConversionEvent"}},"/accounts/{accountId}/native/outbrain/updateConversionEvent":{"post":{"summary":"Prepare outbrain updateConversionEvent (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"conversionEventId":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000},"url":{"type":"string","maxLength":100000},"category":{"type":"string","enum":["PURCHASE","CHECKOUT","ADD_TO_CART","LEAD","REGISTRATION","EMAIL_SIGN_UP","CONTENT_VIEW","VIDEO_VIEW","DOWNLOAD","SEARCH","OTHER","TIME_ON_PAGE","MOUSE_CLICK","SCROLL_DEPTH"]},"conversionWindow":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"includeInConversions":{"type":"boolean"},"enabled":{"type":"boolean"},"orderValue":{"type":"number"},"orderCurrency":{"type":"string","maxLength":100000},"timeOnPageSettingValue":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scrollDepthSettingValue":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["conversionEventId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_outbrain_updateConversionEvent"}},"/accounts/{accountId}/native/outbrain/listEngagementMetrics":{"post":{"summary":"Read outbrain listEngagementMetrics (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_outbrain_listEngagementMetrics"}},"/accounts/{accountId}/native/outbrain/listUsers":{"post":{"summary":"Read outbrain listUsers (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_outbrain_listUsers"}},"/accounts/{accountId}/native/outbrain/inviteUsers":{"post":{"summary":"Prepare outbrain inviteUsers (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"emails":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"role":{"type":"string","enum":["ADMIN","CAMPAIGN_MANAGER","VIEWER"]}},"required":["emails","role"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_outbrain_inviteUsers"}},"/accounts/{accountId}/native/outbrain/updateUsers":{"post":{"summary":"Prepare outbrain updateUsers (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"emails":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}},"role":{"type":"string","enum":["ADMIN","CAMPAIGN_MANAGER","VIEWER"]},"enabled":{"type":"boolean"}},"required":["emails"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_outbrain_updateUsers"}},"/accounts/{accountId}/native/outbrain/revokeInvitations":{"post":{"summary":"Prepare outbrain revokeInvitations (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"invitationIds":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["invitationIds"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_outbrain_revokeInvitations"}},"/accounts/{accountId}/native/outbrain/removeUsers":{"post":{"summary":"Prepare outbrain removeUsers (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"emails":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["emails"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_outbrain_removeUsers"}},"/accounts/{accountId}/native/outbrain/realtimeByMinute":{"post":{"summary":"Read outbrain realtimeByMinute (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"minutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"campaignId":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_outbrain_realtimeByMinute"}},"/accounts/{accountId}/native/outbrain/realtimeByHour":{"post":{"summary":"Read outbrain realtimeByHour (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"campaignId":{"type":"string","maxLength":100000}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_outbrain_realtimeByHour"}},"/accounts/{accountId}/native/outbrain/realtimeCampaignHours":{"post":{"summary":"Read outbrain realtimeCampaignHours (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignId":{"type":"string","maxLength":100000},"hours":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["campaignId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_outbrain_realtimeCampaignHours"}},"/accounts/{accountId}/native/snapchat/listLeadForms":{"post":{"summary":"Read snapchat listLeadForms (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_snapchat_listLeadForms"}},"/accounts/{accountId}/native/snapchat/createLeadForm":{"post":{"summary":"Prepare snapchat createLeadForm (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"title":{"type":"string","maxLength":100000},"description":{"type":"string","maxLength":100000},"privacy_policy_url":{"type":"string","maxLength":100000},"form_fields":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"end_page_properties":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"banner_media_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["name","title","description","form_fields"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_snapchat_createLeadForm"}},"/accounts/{accountId}/native/snapchat/listPixels":{"post":{"summary":"Read snapchat listPixels (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_snapchat_listPixels"}},"/accounts/{accountId}/native/snapchat/listCatalogs":{"post":{"summary":"Read snapchat listCatalogs (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_snapchat_listCatalogs"}},"/accounts/{accountId}/native/snapchat/createCatalog":{"post":{"summary":"Prepare snapchat createCatalog (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"vertical":{"type":"string","enum":["COMMERCE","HOTELS","PLACES","FLIGHTS"]},"pixel_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_snapchat_createCatalog"}},"/accounts/{accountId}/native/snapchat/listProductFeeds":{"post":{"summary":"Read snapchat listProductFeeds (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["catalog_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_snapchat_listProductFeeds"}},"/accounts/{accountId}/native/snapchat/createProductFeed":{"post":{"summary":"Prepare snapchat createProductFeed (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","maxLength":100000},"default_currency":{"type":"string","maxLength":100000},"schedule":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["catalog_id","name"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_snapchat_createProductFeed"}},"/accounts/{accountId}/native/snapchat/listProductSets":{"post":{"summary":"Read snapchat listProductSets (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["catalog_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_snapchat_listProductSets"}},"/accounts/{accountId}/native/snapchat/createProductSet":{"post":{"summary":"Prepare snapchat createProductSet (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","maxLength":100000},"filter":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["catalog_id","name","filter"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_snapchat_createProductSet"}},"/accounts/{accountId}/native/snapchat/listDynamicTemplates":{"post":{"summary":"Read snapchat listDynamicTemplates (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_snapchat_listDynamicTemplates"}},"/accounts/{accountId}/native/snapchat/sendConversionEvents":{"post":{"summary":"Prepare snapchat sendConversionEvents (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"pixel_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"data":{"maxItems":10000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"validate_only":{"type":"boolean"}},"required":["pixel_id","data"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_snapchat_sendConversionEvents"}},"/accounts/{accountId}/native/amazon/listPortfolios":{"post":{"summary":"Read amazon listPortfolios (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_listPortfolios"}},"/accounts/{accountId}/native/amazon/createPortfolio":{"post":{"summary":"Prepare amazon createPortfolio (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"portfolio":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"budget":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"policy":{"type":"string","enum":["DATE_RANGE","MONTHLY_RECURRING","NO_CAP"]},"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["policy"],"additionalProperties":false},"budgetControls":{"type":"object","properties":{"campaignUnspentBudgetSharing":{"type":"object","properties":{"featureState":{"type":"string","enum":["ENABLED","DISABLED"]}},"required":["featureState"],"additionalProperties":false}},"required":["campaignUnspentBudgetSharing"],"additionalProperties":false}},"required":["name"],"additionalProperties":false}},"required":["portfolio"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_createPortfolio"}},"/accounts/{accountId}/native/amazon/updatePortfolio":{"post":{"summary":"Prepare amazon updatePortfolio (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"portfolioId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"changes":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"budget":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"currencyCode":{"type":"string","pattern":"^[A-Z]{3}$"},"policy":{"type":"string","enum":["DATE_RANGE","MONTHLY_RECURRING","NO_CAP"]},"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["policy"],"additionalProperties":false},"budgetControls":{"type":"object","properties":{"campaignUnspentBudgetSharing":{"type":"object","properties":{"featureState":{"type":"string","enum":["ENABLED","DISABLED"]}},"required":["featureState"],"additionalProperties":false}},"required":["campaignUnspentBudgetSharing"],"additionalProperties":false}},"additionalProperties":false}},"required":["portfolioId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_updatePortfolio"}},"/accounts/{accountId}/native/amazon/listBudgetRules":{"post":{"summary":"Read amazon listBudgetRules (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adProduct":{"type":"string","enum":["SP","SB"]}},"required":["adProduct"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_listBudgetRules"}},"/accounts/{accountId}/native/amazon/createBudgetRule":{"post":{"summary":"Prepare amazon createBudgetRule (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adProduct":{"type":"string","enum":["SP","SB"]},"rule":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["SCHEDULE","PERFORMANCE"]},"budgetIncreaseBy":{"type":"object","properties":{"type":{"type":"string","const":"PERCENT"},"value":{"type":"number","exclusiveMinimum":0,"maximum":900}},"required":["type","value"],"additionalProperties":false},"duration":{"type":"object","properties":{"dateRangeTypeRuleDuration":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"}},"required":["startDate"],"additionalProperties":false},"eventTypeRuleDuration":{"type":"object","properties":{"eventId":{"type":"string","minLength":1,"maxLength":200}},"required":["eventId"],"additionalProperties":false}},"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","const":"DAILY"},"daysOfWeek":{"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"intraDaySchedule":{"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},"endTime":{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"performanceMeasureCondition":{"type":"object","properties":{"metricName":{"type":"string","enum":["ACOS","CTR","CVR","ROAS"]},"comparisonOperator":{"type":"string","enum":["EQUAL_TO","GREATER_THAN","GREATER_THAN_OR_EQUAL_TO","LESS_THAN","LESS_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number"}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}},"required":["name","ruleType","budgetIncreaseBy","duration"],"additionalProperties":false}},"required":["adProduct","rule"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_createBudgetRule"}},"/accounts/{accountId}/native/amazon/updateBudgetRule":{"post":{"summary":"Prepare amazon updateBudgetRule (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adProduct":{"type":"string","enum":["SP","SB"]},"ruleId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"},"rule":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["SCHEDULE","PERFORMANCE"]},"budgetIncreaseBy":{"type":"object","properties":{"type":{"type":"string","const":"PERCENT"},"value":{"type":"number","exclusiveMinimum":0,"maximum":900}},"required":["type","value"],"additionalProperties":false},"duration":{"type":"object","properties":{"dateRangeTypeRuleDuration":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"}},"required":["startDate"],"additionalProperties":false},"eventTypeRuleDuration":{"type":"object","properties":{"eventId":{"type":"string","minLength":1,"maxLength":200}},"required":["eventId"],"additionalProperties":false}},"additionalProperties":false},"recurrence":{"type":"object","properties":{"type":{"type":"string","const":"DAILY"},"daysOfWeek":{"maxItems":7,"type":"array","items":{"type":"string","enum":["MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY","SUNDAY"]}},"intraDaySchedule":{"maxItems":1,"type":"array","items":{"type":"object","properties":{"startTime":{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},"endTime":{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"}},"required":["startTime","endTime"],"additionalProperties":false}}},"required":["type"],"additionalProperties":false},"performanceMeasureCondition":{"type":"object","properties":{"metricName":{"type":"string","enum":["ACOS","CTR","CVR","ROAS"]},"comparisonOperator":{"type":"string","enum":["EQUAL_TO","GREATER_THAN","GREATER_THAN_OR_EQUAL_TO","LESS_THAN","LESS_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number"}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}},"required":["name","ruleType","budgetIncreaseBy","duration"],"additionalProperties":false}},"required":["adProduct","ruleId","rule"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_updateBudgetRule"}},"/accounts/{accountId}/native/amazon/listCampaignBudgetRules":{"post":{"summary":"Read amazon listCampaignBudgetRules (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adProduct":{"type":"string","enum":["SP","SB"]},"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["adProduct","campaignId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_listCampaignBudgetRules"}},"/accounts/{accountId}/native/amazon/attachBudgetRules":{"post":{"summary":"Prepare amazon attachBudgetRules (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adProduct":{"type":"string","enum":["SP","SB"]},"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"ruleIds":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"}}},"required":["adProduct","campaignId","ruleIds"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_attachBudgetRules"}},"/accounts/{accountId}/native/amazon/detachBudgetRule":{"post":{"summary":"Prepare amazon detachBudgetRule (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adProduct":{"type":"string","enum":["SP","SB"]},"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"ruleId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"}},"required":["adProduct","campaignId","ruleId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_detachBudgetRule"}},"/accounts/{accountId}/native/amazon/budgetRuleRecommendations":{"post":{"summary":"Read amazon budgetRuleRecommendations (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"required":["campaignId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_budgetRuleRecommendations"}},"/accounts/{accountId}/native/amazon/createOptimizationRule":{"post":{"summary":"Prepare amazon createOptimizationRule (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"rule":{"type":"object","properties":{"campaignIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"ruleName":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["BID","KEYWORD","PRODUCT"]},"ruleAction":{"type":"string","const":"ADOPT"},"recurrence":{"type":"string","const":"DAILY"},"ruleCondition":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"metricName":{"type":"string","enum":["AVERAGE_BID","ROAS"]},"comparisonOperator":{"type":"string","enum":["EQUAL_TO","GREATER_THAN","GREATER_THAN_OR_EQUAL_TO","LESS_THAN","LESS_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number"}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}}},"required":["campaignIds","ruleType","ruleAction","recurrence"],"additionalProperties":false}},"required":["rule"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_createOptimizationRule"}},"/accounts/{accountId}/native/amazon/updateOptimizationRule":{"post":{"summary":"Prepare amazon updateOptimizationRule (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"ruleId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"},"rule":{"type":"object","properties":{"campaignIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"ruleName":{"type":"string","minLength":1,"maxLength":355},"ruleType":{"type":"string","enum":["BID","KEYWORD","PRODUCT"]},"ruleAction":{"type":"string","const":"ADOPT"},"recurrence":{"type":"string","const":"DAILY"},"ruleCondition":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"metricName":{"type":"string","enum":["AVERAGE_BID","ROAS"]},"comparisonOperator":{"type":"string","enum":["EQUAL_TO","GREATER_THAN","GREATER_THAN_OR_EQUAL_TO","LESS_THAN","LESS_THAN_OR_EQUAL_TO"]},"threshold":{"type":"number"}},"required":["metricName","comparisonOperator","threshold"],"additionalProperties":false}}},"required":["campaignIds","ruleType","ruleAction","recurrence"],"additionalProperties":false}},"required":["ruleId","rule"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_updateOptimizationRule"}},"/accounts/{accountId}/native/amazon/getOptimizationRule":{"post":{"summary":"Read amazon getOptimizationRule (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"ruleId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"}},"required":["ruleId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_getOptimizationRule"}},"/accounts/{accountId}/native/amazon/deleteOptimizationRule":{"post":{"summary":"Prepare amazon deleteOptimizationRule (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"ruleId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"}},"required":["ruleId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_deleteOptimizationRule"}},"/accounts/{accountId}/native/amazon/optimizationRuleEligibility":{"post":{"summary":"Read amazon optimizationRuleEligibility (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}}},"required":["campaignIds"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_optimizationRuleEligibility"}},"/accounts/{accountId}/native/amazon/targetPromotionGroupRecommendations":{"post":{"summary":"Read amazon targetPromotionGroupRecommendations (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adGroupId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_targetPromotionGroupRecommendations"}},"/accounts/{accountId}/native/amazon/listTargetPromotionGroups":{"post":{"summary":"Read amazon listTargetPromotionGroups (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"adGroupId":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_listTargetPromotionGroups"}},"/accounts/{accountId}/native/amazon/createTargetPromotionGroup":{"post":{"summary":"Prepare amazon createTargetPromotionGroup (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"group":{"type":"object","properties":{"adGroupId":{"type":"string","maxLength":30,"pattern":"^\\d+$"},"adIds":{"maxItems":100,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}},"existingCampaignDetails":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"newCampaignDetails":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["adGroupId"],"additionalProperties":false}},"required":["group"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_createTargetPromotionGroup"}},"/accounts/{accountId}/native/amazon/addTargetPromotionGroupTargets":{"post":{"summary":"Prepare amazon addTargetPromotionGroupTargets (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"groupId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"},"targets":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}},"required":["groupId","targets"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_addTargetPromotionGroupTargets"}},"/accounts/{accountId}/native/amazon/listTargetPromotionGroupTargets":{"post":{"summary":"Read amazon listTargetPromotionGroupTargets (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"groupId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"}},"required":["groupId"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_listTargetPromotionGroupTargets"}},"/accounts/{accountId}/native/amazon/getCampaignRecommendations":{"post":{"summary":"Read amazon getCampaignRecommendations (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"campaignIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","maxLength":30,"pattern":"^\\d+$"}}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_getCampaignRecommendations"}},"/accounts/{accountId}/native/amazon/listAttributionPublishers":{"post":{"summary":"Read amazon listAttributionPublishers (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_listAttributionPublishers"}},"/accounts/{accountId}/native/amazon/listAttributionAdvertisers":{"post":{"summary":"Read amazon listAttributionAdvertisers (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_listAttributionAdvertisers"}},"/accounts/{accountId}/native/amazon/getAttributionTags":{"post":{"summary":"Read amazon getAttributionTags (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"publisherIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"}},"advertiserIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,64}$"}},"macro":{"type":"boolean"}},"required":["publisherIds"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_getAttributionTags"}},"/accounts/{accountId}/native/amazon/attributionReport":{"post":{"summary":"Read amazon attributionReport (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"report":{"type":"object","properties":{"advertiserIds":{"type":"string","maxLength":2000},"startDate":{"type":"string","pattern":"^\\d{8}$"},"endDate":{"type":"string","pattern":"^\\d{8}$"},"reportType":{"type":"string","enum":["PERFORMANCE","PRODUCTS"]},"groupBy":{"type":"string","enum":["CAMPAIGN","AD_GROUP","CREATIVE"]},"metrics":{"type":"string","maxLength":2000},"count":{"type":"integer","minimum":1,"maximum":5000},"cursorId":{"type":"string","maxLength":500}},"required":["startDate","endDate"],"additionalProperties":false}},"required":["report"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_attributionReport"}},"/accounts/{accountId}/native/amazon/listStreamSubscriptions":{"post":{"summary":"Read amazon listStreamSubscriptions (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_amazon_listStreamSubscriptions"}},"/accounts/{accountId}/native/amazon/createStreamSubscription":{"post":{"summary":"Prepare amazon createStreamSubscription (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"subscription":{"type":"object","properties":{"dataSetId":{"type":"string","pattern":"^[a-z0-9-]{1,80}$"},"destinationArn":{"type":"string","maxLength":2048,"pattern":"^arn:aws:(sqs|firehose):"},"destination":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"notes":{"type":"string","maxLength":128}},"required":["dataSetId"],"additionalProperties":false}},"required":["subscription"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_createStreamSubscription"}},"/accounts/{accountId}/native/amazon/updateStreamSubscription":{"post":{"summary":"Prepare amazon updateStreamSubscription (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"subscriptionId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,120}$"},"changes":{"type":"object","properties":{"status":{"type":"string","enum":["ACTIVE","ARCHIVED"]},"notes":{"type":"string","maxLength":128}},"additionalProperties":false}},"required":["subscriptionId","changes"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_amazon_updateStreamSubscription"}},"/accounts/{accountId}/native/reddit/listProductCatalogs":{"post":{"summary":"Read reddit listProductCatalogs (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_reddit_listProductCatalogs"}},"/accounts/{accountId}/native/reddit/createProductCatalog":{"post":{"summary":"Prepare reddit createProductCatalog (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"name":{"type":"string","maxLength":100000},"default_language":{"type":"string","enum":["en","de","es","fr","it","pt"]},"default_currency":{"type":"string","enum":["USD","GBP","CAD","EUR","AUD","JPY","CHF","NZD","SEK","NOK"]},"event_sources":{"maxItems":10000,"type":"array","items":{"type":"string","maxLength":100000}}},"required":["name","default_language","default_currency"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_reddit_createProductCatalog"}},"/accounts/{accountId}/native/reddit/listProductSets":{"post":{"summary":"Read reddit listProductSets (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000}},"required":["catalog_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_reddit_listProductSets"}},"/accounts/{accountId}/native/reddit/createProductSet":{"post":{"summary":"Prepare reddit createProductSet (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000},"filter":{"type":"string","maxLength":100000}},"required":["catalog_id","name","filter"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_reddit_createProductSet"}},"/accounts/{accountId}/native/reddit/updateProductSet":{"post":{"summary":"Prepare reddit updateProductSet (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"product_set_id":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000},"filter":{"type":"string","maxLength":100000}},"required":["product_set_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_reddit_updateProductSet"}},"/accounts/{accountId}/native/reddit/deleteProductSet":{"post":{"summary":"Prepare reddit deleteProductSet (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"product_set_id":{"type":"string","maxLength":100000}},"required":["product_set_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_reddit_deleteProductSet"}},"/accounts/{accountId}/native/reddit/listProductFeeds":{"post":{"summary":"Read reddit listProductFeeds (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000}},"required":["catalog_id"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_reddit_listProductFeeds"}},"/accounts/{accountId}/native/reddit/createProductFeed":{"post":{"summary":"Prepare reddit createProductFeed (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"catalog_id":{"type":"string","maxLength":100000},"name":{"type":"string","maxLength":100000},"url":{"type":"string","maxLength":100000}},"required":["catalog_id","name","url"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_reddit_createProductFeed"}},"/accounts/{accountId}/native/reddit/listPixels":{"post":{"summary":"Read reddit listPixels (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_reddit_listPixels"}},"/accounts/{accountId}/native/reddit/listChangeHistory":{"post":{"summary":"Read reddit listChangeHistory (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"start_date":{"type":"string","format":"date","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])))$"},"end_date":{"type":"string","format":"date","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])))$"},"entity_id":{"type":"string","maxLength":100000},"change_types":{"maxItems":10000,"type":"array","items":{"type":"string","enum":["AD_ACCOUNT","AD","AD_GROUP","AUDIENCE","BID","BUDGET","CAMPAIGN","STATUS","TARGETING"]}}},"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_native_reddit_listChangeHistory"}},"/accounts/{accountId}/native/reddit/sendConversionEvents":{"post":{"summary":"Prepare reddit sendConversionEvents (account)","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"params":{"type":"object","properties":{"pixel_id":{"type":"string","maxLength":100000},"event":{"type":"string","enum":["PAGE_VISIT","VIEW_CONTENT","SEARCH","ADD_TO_CART","ADD_TO_WISHLIST","PURCHASE","LEAD","SIGN_UP","CUSTOM"]},"custom_event_name":{"type":"string","maxLength":100000},"event_time":{"type":"string","maxLength":100000},"action_source":{"type":"string","enum":["WEBSITE","APP","OTHER","PHYSICAL_STORE"]},"email":{"type":"string","maxLength":100000},"click_id":{"type":"string","maxLength":100000},"value":{"type":"number"},"currency":{"type":"string","maxLength":100000},"conversion_id":{"type":"string","maxLength":100000},"test_id":{"type":"string","maxLength":100000}},"required":["pixel_id","event","event_time"],"additionalProperties":false}},"required":["params"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":false,"operationId":"post_accounts_accountId_native_reddit_sendConversionEvents"}},"/rules":{"get":{"summary":"List automated rules: conditions on spend, CPA, ROAS, CTR, CPC, CPM, conversions or frequency over a window, at campaign, ad group or ad level across accounts, with their action, schedule and safety settings","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_rules"},"post":{"summary":"Create an automated rule that works the same on every network. Actions: pause, activate, change budget or bid by a percentage or to an amount (each network's budget rules still apply), or notify. Runs hourly or daily. By default every run prepares reviewed operations; auto-execute can only be turned on by the owner in Kads, never from an API key or agent","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":1000},"enabled":{"default":true,"type":"boolean"},"accountIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"level":{"type":"string","enum":["campaign","adGroup","ad"]},"scope":{"default":{"status":"active"},"type":"object","properties":{"status":{"default":"active","type":"string","enum":["active","any"]},"nameContains":{"type":"string","maxLength":120}},"additionalProperties":false},"window":{"type":"string","enum":["today","yesterday","last_3_days","last_7_days","last_14_days","last_30_days"]},"conditions":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string","enum":["spend","impressions","clicks","conversions","cpa","roas","ctr","cpc","cpm","frequency"]},"operator":{"type":"string","enum":["gt","gte","lt","lte"]},"value":{"type":"number","minimum":0,"maximum":1000000000}},"required":["metric","operator","value"],"additionalProperties":false}},"action":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"pause"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"activate"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"budget"},"change":{"type":"object","properties":{"mode":{"type":"string","enum":["percent","amount"]},"value":{"type":"number"},"min":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"max":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["mode","value"],"additionalProperties":false}},"required":["type","change"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"bid"},"change":{"type":"object","properties":{"mode":{"type":"string","enum":["percent","amount"]},"value":{"type":"number"},"min":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"max":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["mode","value"],"additionalProperties":false}},"required":["type","change"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"notify"}},"required":["type"],"additionalProperties":false}]},"schedule":{"oneOf":[{"type":"object","properties":{"every":{"type":"string","const":"hour"}},"required":["every"],"additionalProperties":false},{"type":"object","properties":{"every":{"type":"string","const":"day"},"hourUtc":{"default":8,"type":"integer","minimum":0,"maximum":23}},"required":["every"],"additionalProperties":false}]},"safety":{"default":{"autoExecute":false,"maxChangesPerRun":5,"cooldownHours":24},"type":"object","properties":{"autoExecute":{"default":false,"type":"boolean"},"maxChangesPerRun":{"default":5,"type":"integer","minimum":1,"maximum":50},"cooldownHours":{"default":24,"type":"integer","minimum":1,"maximum":720}},"additionalProperties":false}},"required":["name","accountIds","level","window","conditions","action","schedule"],"additionalProperties":false}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_rules"}},"/rules/features":{"get":{"summary":"Read the rule metrics and, per network, which levels have budgets and bids, whether frequency is available, and the network's own rule engine that keeps running alongside Kads","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_rules_features"}},"/rules/preview":{"post":{"summary":"Dry-run an unsaved rule: which items match right now and exactly what would change. Nothing is prepared or sent","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":1000},"enabled":{"default":true,"type":"boolean"},"accountIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"level":{"type":"string","enum":["campaign","adGroup","ad"]},"scope":{"default":{"status":"active"},"type":"object","properties":{"status":{"default":"active","type":"string","enum":["active","any"]},"nameContains":{"type":"string","maxLength":120}},"additionalProperties":false},"window":{"type":"string","enum":["today","yesterday","last_3_days","last_7_days","last_14_days","last_30_days"]},"conditions":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string","enum":["spend","impressions","clicks","conversions","cpa","roas","ctr","cpc","cpm","frequency"]},"operator":{"type":"string","enum":["gt","gte","lt","lte"]},"value":{"type":"number","minimum":0,"maximum":1000000000}},"required":["metric","operator","value"],"additionalProperties":false}},"action":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"pause"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"activate"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"budget"},"change":{"type":"object","properties":{"mode":{"type":"string","enum":["percent","amount"]},"value":{"type":"number"},"min":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"max":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["mode","value"],"additionalProperties":false}},"required":["type","change"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"bid"},"change":{"type":"object","properties":{"mode":{"type":"string","enum":["percent","amount"]},"value":{"type":"number"},"min":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"max":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["mode","value"],"additionalProperties":false}},"required":["type","change"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"notify"}},"required":["type"],"additionalProperties":false}]},"schedule":{"oneOf":[{"type":"object","properties":{"every":{"type":"string","const":"hour"}},"required":["every"],"additionalProperties":false},{"type":"object","properties":{"every":{"type":"string","const":"day"},"hourUtc":{"default":8,"type":"integer","minimum":0,"maximum":23}},"required":["every"],"additionalProperties":false}]},"safety":{"default":{"autoExecute":false,"maxChangesPerRun":5,"cooldownHours":24},"type":"object","properties":{"autoExecute":{"default":false,"type":"boolean"},"maxChangesPerRun":{"default":5,"type":"integer","minimum":1,"maximum":50},"cooldownHours":{"default":24,"type":"integer","minimum":1,"maximum":720}},"additionalProperties":false}},"required":["name","accountIds","level","window","conditions","action","schedule"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_rules_preview"}},"/rules/{ruleId}":{"get":{"summary":"Read one rule, with notes on each network's own rules","parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_rules_ruleId"},"patch":{"summary":"Change a rule you own. A change from an API key or agent turns auto-execute off","parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","maxLength":1000},"enabled":{"type":"boolean"},"accountIds":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"level":{"type":"string","enum":["campaign","adGroup","ad"]},"scope":{"type":"object","properties":{"status":{"default":"active","type":"string","enum":["active","any"]},"nameContains":{"type":"string","maxLength":120}},"additionalProperties":false},"window":{"type":"string","enum":["today","yesterday","last_3_days","last_7_days","last_14_days","last_30_days"]},"conditions":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"metric":{"type":"string","enum":["spend","impressions","clicks","conversions","cpa","roas","ctr","cpc","cpm","frequency"]},"operator":{"type":"string","enum":["gt","gte","lt","lte"]},"value":{"type":"number","minimum":0,"maximum":1000000000}},"required":["metric","operator","value"],"additionalProperties":false}},"action":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"pause"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"activate"}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"budget"},"change":{"type":"object","properties":{"mode":{"type":"string","enum":["percent","amount"]},"value":{"type":"number"},"min":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"max":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["mode","value"],"additionalProperties":false}},"required":["type","change"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"bid"},"change":{"type":"object","properties":{"mode":{"type":"string","enum":["percent","amount"]},"value":{"type":"number"},"min":{"type":"number","exclusiveMinimum":0,"maximum":1000000000},"max":{"type":"number","exclusiveMinimum":0,"maximum":1000000000}},"required":["mode","value"],"additionalProperties":false}},"required":["type","change"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"notify"}},"required":["type"],"additionalProperties":false}]},"schedule":{"oneOf":[{"type":"object","properties":{"every":{"type":"string","const":"hour"}},"required":["every"],"additionalProperties":false},{"type":"object","properties":{"every":{"type":"string","const":"day"},"hourUtc":{"default":8,"type":"integer","minimum":0,"maximum":23}},"required":["every"],"additionalProperties":false}]},"safety":{"type":"object","properties":{"autoExecute":{"default":false,"type":"boolean"},"maxChangesPerRun":{"default":5,"type":"integer","minimum":1,"maximum":50},"cooldownHours":{"default":24,"type":"integer","minimum":1,"maximum":720}},"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_rules_ruleId"},"delete":{"summary":"Delete a rule (owner or workspace admin). Operations it already prepared stay in review","parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_rules_ruleId"}},"/rules/{ruleId}/preview":{"post":{"summary":"Dry-run a saved rule: matches, current metrics and the change each would get, honouring its cooldown and per-run cap. Nothing is prepared or sent","parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_rules_ruleId_preview"}},"/rules/{ruleId}/run":{"post":{"summary":"Run a rule you own now. Prepares reviewed operations (or executes them when the owner turned on auto-execute in Kads) and records the run log","parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_rules_ruleId_run"}},"/rules/{ruleId}/runs":{"get":{"summary":"Read a rule's run log: every item it matched, the metrics, the change, and whether it was prepared, executed, skipped (and why) or failed","parameters":[{"name":"ruleId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_rules_ruleId_runs"}},"/experiments":{"get":{"summary":"List A/B tests: network-controlled splits (Meta, Google Ads, TikTok, LinkedIn) and Kads comparisons","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_experiments"},"post":{"summary":"Prepare an A/B test. method native uses the network's own experiments API (Meta A/B test, Google Ads custom experiment, TikTok split test, LinkedIn A/B test) and saves a reviewed operation to execute; method comparison compares two to seven items from their reported results and is labelled as not a network-controlled split. Read /experiments/features for each network's rules","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"accountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":100},"hypothesis":{"type":"string","maxLength":1000},"method":{"type":"string","enum":["native","comparison"]},"level":{"type":"string","enum":["campaign","adGroup","ad"]},"keyMetric":{"type":"string","enum":["cpa","roas","ctr","cvr","cpc","cpm"]},"confidence":{"default":90,"type":"integer","minimum":51,"maximum":99},"startAt":{"type":"string","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)))$"},"endAt":{"type":"string","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)))$"},"arms":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"object","properties":{"entityId":{"type":"string","minLength":1,"maxLength":250},"name":{"type":"string","maxLength":80},"share":{"type":"integer","minimum":1,"maximum":99}},"required":["entityId"],"additionalProperties":false}},"settings":{"default":{},"type":"object","properties":{"dailyBudget":{"type":"number","exclusiveMinimum":0,"maximum":100000000},"budget":{"type":"number","exclusiveMinimum":0,"maximum":100000000},"testVariable":{"type":"string","enum":["BIDDING_OPTIMIZATION","TARGTING","CREATIVE"]},"treatment":{"type":"object","properties":{"bidding":{"type":"object","properties":{"strategy":{"type":"string","enum":["lowest_cost","cost_cap","bid_cap","target_roas","enhanced_cpc","manual_cpc","manual_cpm","maximize_clicks","maximize_conversions","maximize_value","target_cpa","target_impression_share"]},"amount":{"type":"number","exclusiveMinimum":0},"roas":{"type":"number","exclusiveMinimum":0,"maximum":1000},"share":{"type":"number","exclusiveMinimum":0,"maximum":100},"position":{"type":"string","enum":["anywhere","top","absolute_top"]}},"required":["strategy"],"additionalProperties":false}},"required":["bidding"],"additionalProperties":false},"autoStop":{"type":"string","enum":["AUTO_STOP_AT_END_DATE","AUTO_STOP_AT_WINNER","AUTO_STOP_DISABLED"]}},"additionalProperties":false}},"required":["accountId","name","method","level","keyMetric","startAt","endAt","arms"],"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_experiments"}},"/experiments/features":{"get":{"summary":"Read which networks run native A/B tests through their API, the levels, number of items, metrics and limits each allows, and why the others only offer a Kads comparison","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_experiments_features"}},"/experiments/{experimentId}":{"get":{"summary":"Read an A/B test with its read-out: the network's own status and verdict for native tests, and Kads' significance test on reported results","parameters":[{"name":"experimentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_experiments_experimentId"},"delete":{"summary":"Remove an A/B test from Kads (a running network test must be ended first)","parameters":[{"name":"experimentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_experiments_experimentId"}},"/experiments/{experimentId}/results":{"get":{"summary":"Read an A/B test's results and significance","parameters":[{"name":"experimentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_experiments_experimentId_results"}},"/experiments/{experimentId}/end":{"post":{"summary":"Prepare ending a network A/B test (or promoting a Google Ads treatment into its control campaign) for review; a comparison just closes","parameters":[{"name":"experimentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Reuses the same prepared operation for the same canonical request. A changed payload returns 409."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"default":"end","type":"string","enum":["end","promote"]}},"additionalProperties":false}}}},"responses":{"201":{"description":"Prepared operation; no provider write until explicit execution.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_experiments_experimentId_end"}},"/account-groups":{"get":{"summary":"List named advertising account groups","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_account_groups"},"post":{"summary":"Create an advertising account group","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"color":{"default":"#6366f1","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accountIds":{"maxItems":500,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["name","color","accountIds"],"additionalProperties":false}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"post_account_groups"}},"/account-groups/{groupId}":{"patch":{"summary":"Update an advertising account group","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100},"color":{"default":"#6366f1","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accountIds":{"maxItems":500,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["name","color","accountIds"],"additionalProperties":false}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"patch_account_groups_groupId"},"delete":{"summary":"Delete an account group without disconnecting its accounts","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"delete_account_groups_groupId"}},"/usage":{"get":{"summary":"Read 30-day API request usage and workspace rate limits","parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_usage"}},"/request-logs":{"get":{"summary":"Read request metadata without bodies, headers or credentials","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"before","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"status","in":"query","required":false,"schema":{"type":"integer","minimum":100,"maximum":599}},{"name":"accountId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"requestId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_request_logs"}},"/accounts/{accountId}/syncs":{"get":{"summary":"List resumable account data syncs","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_syncs"},"post":{"summary":"Queue a read-only entity and daily metrics sync for up to 730 days","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"startDate":{"type":"string","format":"date","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])))$"},"endDate":{"type":"string","format":"date","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])))$"}},"required":["startDate","endDate"],"additionalProperties":false}}}},"responses":{"202":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_syncs"}},"/accounts/{accountId}/syncs/{syncId}":{"get":{"summary":"Read data sync progress and reporting readiness","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"syncId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_syncs_syncId"}},"/accounts/{accountId}/syncs/{syncId}/continue":{"post":{"summary":"Advance one resumable provider read without publishing changes","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"syncId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"x-kads-read-only":true,"operationId":"post_accounts_accountId_syncs_syncId_continue"}},"/accounts/{accountId}/cached-insights":{"get":{"summary":"Read stored daily metrics with explicit missing-day coverage for up to 730 days","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"startDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"endDate","in":"query","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_cached_insights"}},"/accounts/{accountId}/cached-entities/{resource}":{"get":{"summary":"Read a complete entity snapshot and its refresh timestamp","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"resource","in":"path","required":true,"schema":{"type":"string","enum":["campaigns","ad-groups","ads","creatives","budgets","criteria"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"400":{"description":"Provider or operation error; inspect error and operation receipt before retry"},"401":{"description":"Missing, invalid, expired or revoked bearer token"},"403":{"description":"Workspace or token permissions do not permit this action"},"404":{"description":"Account, entity or endpoint not found"},"409":{"description":"Idempotency key was already used with a different account or payload"},"422":{"description":"Invalid input or unsupported native capability"}},"operationId":"get_accounts_accountId_cached_entities_resource"}}},"components":{"securitySchemes":{"advertisingToken":{"type":"http","scheme":"bearer","bearerFormat":"kads_ads_…"}},"schemas":{"Envelope":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"type":"object","properties":{"requestId":{"type":"string"}},"additionalProperties":true}}},"Mutation":{"type":"object","additionalProperties":false,"required":["kind","action","payload"],"properties":{"parentId":{"type":"string"},"payload":{"type":"object","additionalProperties":true},"kind":{"type":"string","enum":["campaign","adGroup","ad","creative","budget","criterion"]},"action":{"type":"string","enum":["create","update"]},"entityId":{"type":"string"}}}}}}