{"openapi":"3.1.0","info":{"title":"Orbit API","version":"1.0.0","description":"Orbit Audience Intent API: topic discovery, site analysis, curated ICP filters, saved audiences, materialization runs, stats, and CSV export. Discovery endpoints are public; audience management accepts either Bearer JWT or X-API-Key auth."},"servers":[{"url":"https://api.aws53.cloud","description":"Production"}],"paths":{"/v1/intent/topics/analyze":{"post":{"tags":["Site Analysis"],"summary":"Match a website to intent topics","description":"Analyzes website text and returns matching intent topics ranked by similarity with extracted keywords and company context. Results are cached for 24 hours; stale results may be returned while refreshing. Bearer-authenticated searches are saved to the active organization history asynchronously. Source-IP allowance is 2 requests per 60 seconds without a valid bearer token, or 30 with one.","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":10,"format":"uri","description":"Public website URL to analyze.","example":"https://cloud.example.test"}},"required":["url"]},"example":{"url":"https://cloud.example.test"}}}},"responses":{"200":{"description":"Matched topics","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteTopicsResponse"},"example":{"data":{"company":"Example Cloud","summary":"Cloud data management software.","keywords":["cloud platform"],"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing","similarity":0.87,"matchedKeyword":"cloud platform"}]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid URL"},"429":{"description":"Source-IP allowance exceeded: 2 requests per 60 seconds without a valid bearer token, or 30 with one.","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"500":{"description":"Processing error"}},"operationId":"matchAWebsiteToIntentTopics"}},"/v1/site-topics/recent":{"get":{"tags":["Site Topics"],"summary":"Recent site topic searches for the organization","description":"Returns up to 20 site analyses saved by members of the active organization, most recent first. Requires bearer authentication and an active organization. Repeating analysis of the same normalized website updates its existing history entry; saves are asynchronous, so a just-completed analysis may not appear immediately. No saved searches returns an empty list; there is no pagination.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Recent searches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecentSearchesResponse"},"examples":{"populated":{"value":{"data":[{"id":"11111111-1111-4111-8111-111111111111","url":"cloud.example.test","company":"Example Cloud","summary":"Cloud data management software.","topicCount":1,"keywords":["cloud platform"],"topTopics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","similarity":0.87}],"createdAt":"2026-01-15T12:00:00.000Z"}],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":[],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"403":{"description":"The bearer token has no active organization.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"FORBIDDEN","message":"No active organization"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"getRecentSiteTopicSearchesForTheOrganization"}},"/v1/intent/audiences/filters":{"get":{"tags":["Audience Builder"],"summary":"Get available audience filter definitions","description":"Returns the public Orbit audience filter catalog, including supported operators, UI hints, available values, and approximate counts. This public operation allows 2 requests per source IP per 60 seconds without valid authentication, or 200 with a valid bearer token or active organization API key.","security":[],"responses":{"200":{"description":"Audience filter catalog","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceFilterCatalogResponse"},"example":{"data":{"version":{"status":"catalog","sourceTable":"example_profiles","catalogTable":"example_filter_catalog","catalogVersion":"example-v1","buildId":"example-build","buildDate":"2026-01-15","generatedAt":"2026-01-15T12:00:00.000Z"},"summary":{"groupCount":1,"filterCount":1,"valueCount":1,"recommendedFilterCount":1,"standardFilterCount":0,"advancedFilterCount":0,"supportsAdvancedLogic":true,"defaultFieldLogic":"and"},"logic":{"summary":"Use keys from groups[].filters[].key inside audience config.filters. Simple top-level filters are combined with AND. Advanced filters support explicit and/or groups.","uiHints":{"useFields":["key","label","ui","type","valueType","operators","values","maxValues","maxTerms","min","max"],"technicalFields":["sourceColumn","source","requiresSidecar"],"valueHint":"Use values when present for dropdowns. Search-only text filters intentionally do not include values."},"simpleFilters":{"shape":"{ \"filters\": { \"<group>\": { \"<field>\": <value> } } } or { \"filters\": { \"<filter.key>\": <value> } }","topLevelLogic":"AND across different filters.","multiSelectValueLogic":"OR within values for one multi_select filter.","textTermLogic":"text_terms use mode/includeMode \"any\" for OR or \"all\" for AND. jobTitle.exclude and negate=true invert the match."},"advancedFilters":{"enabled":true,"keys":["and","or"],"conditionShape":"{ \"field\": \"<filter.key>\", \"value\": <value> } or { \"field\": \"<filter.key>\", \"values\": [<value>] }","rules":["A group can contain either and or or at the same level, not both.","Top-level simple filters and top-level and/or groups are combined with AND.","Nested OR groups cannot mix serving-only and filter-surface-only filters.","Nested AND groups cannot mix serving-only and filter-surface-only filters; put those filters at top level instead."]},"examples":{"simple":{"company":{"industries":["software development"]}},"or":{"or":[{"field":"company.industries","values":["software development"]},{"field":"company.isSaas","value":true}]},"nested":{"and":[{"field":"contact.hasBusinessEmail","value":true},{"or":[{"field":"company.industries","values":["software development"]},{"field":"company.isSaas","value":true}]}]}}},"groups":[{"key":"company","label":"Company","description":"Company attributes","filters":[{"key":"company.industries","label":"Industry","type":"multi_select","valueType":"enum","operators":["in"],"sourceColumn":"company_industry","source":"both","requiresSidecar":false,"isSearchOnly":false,"maxValues":500,"ui":{"label":"Industry","description":"Company industry","control":"multi_select","section":"recommended","order":10,"recommended":true,"advanced":false},"values":[{"value":"software development","label":"Software Development","count":120}]}]}]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"429":{"description":"Source-IP allowance exceeded: 2 requests per 60 seconds without valid authentication, or 200 with a valid bearer token or active organization API key.","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"getAvailableAudienceFilterDefinitions"}},"/v1/intent/topics":{"get":{"tags":["Topic Discovery"],"summary":"Browse all available intent topics","description":"Returns the available intent-topic catalog with optional type, industry, category, and text filters. Results are ordered by topic name with no guaranteed secondary ordering for equal names. The whole matching catalog is returned without pagination. Catalog results are cached for 24 hours, with stale fallback if refresh fails. Industry and category filters use case-insensitive exact matching; q uses a case-insensitive topic-name substring. This public operation allows 2 requests per source IP per 60 seconds without valid authentication, or 200 with a valid bearer token or active organization API key.","security":[],"parameters":[{"schema":{"type":"string","enum":["b2b","b2c","both"],"description":"Restrict topics to the selected classification; both matches that literal classification.","example":"b2b"},"required":false,"description":"Restrict topics to the selected classification; both matches that literal classification.","name":"type","in":"query","example":"b2b"},{"schema":{"type":"string","maxLength":100,"description":"Filter by industry name.","example":"Technology"},"required":false,"description":"Filter by industry name.","name":"industry","in":"query","example":"Technology"},{"schema":{"type":"string","maxLength":100,"description":"Case-insensitive exact category name.","example":"Cloud Computing"},"required":false,"description":"Case-insensitive exact category name.","name":"category","in":"query","example":"Cloud Computing"},{"schema":{"type":"string","maxLength":100,"description":"Case-insensitive substring of the topic name.","example":"cloud"},"required":false,"description":"Case-insensitive substring of the topic name.","name":"q","in":"query","example":"cloud"}],"responses":{"200":{"description":"Topic catalog","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicInventoryResponse"},"examples":{"populated":{"value":{"data":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}],"meta":{"count":1,"total":3,"filters":{"type":"b2b","industry":null,"category":null,"q":"cloud"}}}},"empty":{"value":{"data":[],"meta":{"count":0,"total":3,"filters":{"type":null,"industry":null,"category":null,"q":"unmatched-example-topic"}}}}}}}},"429":{"description":"Source-IP allowance exceeded: 2 requests per 60 seconds without valid authentication, or 200 with a valid bearer token or active organization API key.","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"browseAllAvailableIntentTopics"}},"/v1/intent/topics/facets":{"get":{"tags":["Topic Discovery"],"summary":"Available filter values for topic inventory","description":"Returns the available topic types, industries, and categories with approximate topic counts for building discovery filters. This public operation allows 2 requests per source IP per 60 seconds without valid authentication, or 200 with a valid bearer token or active organization API key.","security":[],"responses":{"200":{"description":"Facets","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicInventoryFacetsResponse"},"examples":{"populated":{"value":{"data":{"types":[{"value":"b2b","count":1}],"industries":[{"value":"Technology","count":1}],"categories":[{"value":"Cloud Computing","count":1}],"total":1},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":{"types":[],"industries":[],"categories":[],"total":0},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"429":{"description":"Source-IP allowance exceeded: 2 requests per 60 seconds without valid authentication, or 200 with a valid bearer token or active organization API key.","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"getAvailableFilterValuesForTopicInventory"}},"/v1/intent/topics/search":{"get":{"tags":["Topic Discovery"],"summary":"Search topics by name (autocomplete)","description":"Returns up to 50 intent topics whose names match the supplied text, optionally restricted by industry and topic type. Results are intended for autocomplete and are not paginated; ordering is not guaranteed. Industry and type filters use exact matching. This public operation allows 2 requests per source IP per 60 seconds without valid authentication, or 200 with a valid bearer token or active organization API key.","security":[],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":100,"description":"Case-insensitive topic-name search text. SQL wildcard characters percent and underscore are accepted.","example":"cloud"},"required":true,"description":"Case-insensitive topic-name search text. SQL wildcard characters percent and underscore are accepted.","name":"q","in":"query","example":"cloud"},{"schema":{"type":"string","maxLength":100,"description":"Filter by industry name.","example":"Technology"},"required":false,"description":"Filter by industry name.","name":"industry","in":"query","example":"Technology"},{"schema":{"type":"string","enum":["b2b","b2c","both"],"description":"Restrict topics to the selected classification; both matches that literal classification.","example":"b2b"},"required":false,"description":"Restrict topics to the selected classification; both matches that literal classification.","name":"type","in":"query","example":"b2b"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Maximum topics to return; defaults to 10 and allows up to 50.","example":10},"required":false,"description":"Maximum topics to return; defaults to 10 and allows up to 50.","name":"limit","in":"query","example":10}],"responses":{"200":{"description":"Matching topics","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicSearchResponse"},"examples":{"populated":{"value":{"data":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":[],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"429":{"description":"Source-IP allowance exceeded: 2 requests per 60 seconds without valid authentication, or 200 with a valid bearer token or active organization API key.","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed per source IP in 60 seconds.","schema":{"type":"integer","example":2}},"RateLimit-Remaining":{"description":"Requests remaining in the current source-IP window.","schema":{"type":"integer","example":0}},"RateLimit-Reset":{"description":"Seconds until the current source-IP window resets.","schema":{"type":"integer","example":60}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","example":60}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"RATE_LIMIT_EXCEEDED","message":"Too many requests, please try again later"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"searchTopicsByNameAutocomplete"}},"/v1/intent/audiences/preview":{"post":{"tags":["Audience Builder"],"summary":"Preview an intent audience","description":"Counts and samples an audience using the latest available intent snapshot without saving an audience. Requires an authenticated organization member or API key. Sample contact details are masked, and counts can change as new intent data becomes available.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentAudiencePreviewRequest"},"example":{"topicIds":[1001,1002],"minScore":60,"maxScore":99,"minTopicOverlap":1}}}},"responses":{"200":{"description":"Audience preview with masked sample rows","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AudiencePreview"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","dataDate":"2026-01-15","strategy":"serving_table_in","totalCount":0,"breakdowns":{"industries":[],"seniorities":[],"departments":[],"companySizes":[],"states":[],"exportGrades":[],"contactTiers":[]},"sample":[],"appliedFilters":[],"normalizedConfig":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{}}},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid audience config","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApiErrorResponse"},{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"object","properties":{"name":{"type":"string","const":"ZodError"},"message":{"type":"string"}},"required":["name","message"]}},"required":["success","error"]}]}}}}},"operationId":"previewAnIntentAudience"}},"/v1/intent/audiences/validate":{"post":{"tags":["Audience Builder"],"summary":"Validate an intent audience config","description":"Validates and normalizes a topic, score, and filter definition without saving an audience or materializing contacts. Requires an authenticated organization member or organization API key. Returns the normalized configuration, configuration hash, and applied filter fields.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentAudiencePreviewRequest"},"example":{"topicIds":[1001,1002],"minScore":60,"maxScore":99,"minTopicOverlap":1}}}},"responses":{"200":{"description":"Audience config validation result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceValidation"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"valid":true,"configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","normalizedConfig":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{}},"appliedFilters":[],"strategy":"serving_table_in"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid audience config","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApiErrorResponse"},{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"object","properties":{"name":{"type":"string","const":"ZodError"},"message":{"type":"string"}},"required":["name","message"]}},"required":["success","error"]}]}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"validateAnIntentAudienceConfig"}},"/v1/intent/audiences":{"post":{"tags":["Audience Builder"],"summary":"Create an intent audience draft","description":"Saves an audience in the authenticated organization. New audiences default to draft; active creation requires an available audience slot or eligible one-shot access, and paused creation is rejected. The organization can save at most 50 audiences. This operation does not itself materialize contacts.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIntentAudienceRequest"},"example":{"name":"Example cloud research","status":"draft","config":{"topicIds":[1001,1002],"minScore":60}}}}},"responses":{"201":{"description":"Audience created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudience"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud research","status":"draft","config":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{},"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}]},"accessType":"paid","dailyRefreshEnabled":true,"audienceSize":0,"createdBy":null,"lastRefreshedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z","pausedAt":null},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid audience config","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApiErrorResponse"},{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"object","properties":{"name":{"type":"string","const":"ZodError"},"message":{"type":"string"}},"required":["name","message"]}},"required":["success","error"]}]}}}},"403":{"description":"Audience access unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Audience limit or activation conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"createAnIntentAudienceDraft"},"get":{"tags":["Audience Builder"],"summary":"List intent audiences","description":"Returns audiences belonging to the authenticated organization, optionally filtered by status, newest creation first. The limit defaults to 50 and allows up to 100; there is no cursor or offset. Equal creation timestamps have no guaranteed secondary ordering. An organization with no matches receives an empty list.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","enum":["draft","active","paused"],"description":"Restrict results to this audience status.","example":"active"},"required":false,"description":"Restrict results to this audience status.","name":"status","in":"query","example":"active"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Maximum number of records to return. Defaults to 50; maximum 100.","example":50},"required":false,"description":"Maximum number of records to return. Defaults to 50; maximum 100.","name":"limit","in":"query","example":50}],"responses":{"200":{"description":"Audience list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudience"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"examples":{"populated":{"value":{"data":[{"id":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud research","status":"draft","config":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{},"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}]},"accessType":"paid","dailyRefreshEnabled":true,"audienceSize":0,"createdBy":null,"lastRefreshedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z","pausedAt":null}],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":[],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"listIntentAudiences"}},"/v1/intent/audiences/website-visitors":{"get":{"tags":["Audience Builder"],"summary":"List people who are in intent audiences and visited the site","description":"Returns the all-org overlap between latest completed intent audience runs and recent identified website visitors. Results are deduplicated by hashed email and include all latest audience matches for each person.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Maximum overlapping visitors to return; defaults to 100 and allows up to 500.","example":100},"required":false,"description":"Maximum overlapping visitors to return; defaults to 100 and allows up to 500.","name":"limit","in":"query","example":100},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Zero-based number of overlapping visitors to skip.","example":0},"required":false,"description":"Zero-based number of overlapping visitors to skip.","name":"offset","in":"query","example":0}],"responses":{"200":{"description":"All-org overlap between latest intent audience runs and recent website visitors","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceWebsiteVisitorOverlaps"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"state":"no_completed_runs","scope":{"audienceId":null},"audiences":[],"latestRuns":[],"results":[],"total":0,"limit":100,"offset":0,"lookbackDays":90},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"listPeopleWhoAreInIntentAudiencesAndVisitedTheSite"}},"/v1/intent/audiences/website-visitors/{hashedEmail}/topic-history":{"get":{"tags":["Audience Builder"],"summary":"Get matched intent topics over time for a website visitor","description":"Returns chronological intent audience runs where this hashed email appeared, including the topics matched in each run. Use audienceId to scope the history to one saved audience.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-fA-F0-9]{64}$","description":"SHA-256 email hash of the website visitor, as 64 hexadecimal characters.","example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},"required":true,"description":"SHA-256 email hash of the website visitor, as 64 hexadecimal characters.","name":"hashedEmail","in":"path","example":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"},{"schema":{"type":"string","format":"uuid","description":"Restrict history to this audience in the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":false,"description":"Restrict history to this audience in the authenticated organization.","name":"audienceId","in":"query","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":120,"description":"Maximum history points to return; defaults to 120 and allows up to 500.","example":120},"required":false,"description":"Maximum history points to return; defaults to 120 and allows up to 500.","name":"limit","in":"query","example":120}],"responses":{"200":{"description":"Matched intent topics over time for a website visitor","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceWebsiteVisitorTopicHistory"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"hashedEmail":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","audience":null,"points":[{"audienceId":"11111111-1111-4111-8111-111111111111","runId":"22222222-2222-4222-8222-222222222222","resultKey":"example-audience-result","dataDate":"2026-01-15","audience":{"id":"11111111-1111-4111-8111-111111111111","name":"Example cloud research","status":"active"},"run":{"id":"22222222-2222-4222-8222-222222222222","audienceId":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","status":"completed","runType":"manual","configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","dataDate":"2026-01-15","resultKey":"example-audience-result","candidateCount":1,"resultCount":1,"attempts":1,"nextAttemptAt":null,"idempotencyKey":"example-audience-run-2026-01-15","errorCode":null,"errorMessage":null,"startedAt":"2026-01-15T11:59:00.000Z","completedAt":"2026-01-15T12:00:00.000Z","cancelledAt":null,"readyEmailSentAt":null,"readyEmailExportId":null,"readyEmailError":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"intent":{"score":75,"topicOverlap":1,"matchedTopics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}]}}],"limit":120},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getMatchedIntentTopicsOverTimeForAWebsiteVisitor"}},"/v1/intent/audiences/{id}/website-visitors":{"get":{"tags":["Audience Builder"],"summary":"List people in one intent audience who visited the site","description":"Returns the overlap between the latest completed run for this audience and recent identified website visitors.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Maximum overlapping visitors to return; defaults to 100 and allows up to 500.","example":100},"required":false,"description":"Maximum overlapping visitors to return; defaults to 100 and allows up to 500.","name":"limit","in":"query","example":100},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Zero-based number of overlapping visitors to skip.","example":0},"required":false,"description":"Zero-based number of overlapping visitors to skip.","name":"offset","in":"query","example":0}],"responses":{"200":{"description":"Overlap between one latest intent audience run and recent website visitors","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceWebsiteVisitorOverlaps"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"state":"no_completed_runs","scope":{"audienceId":"11111111-1111-4111-8111-111111111111"},"audience":{"id":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud research","status":"draft","config":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{},"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}]},"accessType":"paid","dailyRefreshEnabled":true,"audienceSize":0,"createdBy":null,"lastRefreshedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z","pausedAt":null},"latestRun":null,"results":[],"total":0,"limit":100,"offset":0,"lookbackDays":90},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"listPeopleInOneIntentAudienceWhoVisitedTheSite"}},"/v1/intent/audiences/{id}":{"get":{"tags":["Audience Builder"],"summary":"Get an intent audience","description":"Returns one audience owned by the authenticated organization, including its normalized configuration, topic labels, access type, and refresh state. An audience outside the organization is treated as not found.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"Audience","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudience"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud research","status":"draft","config":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{},"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}]},"accessType":"paid","dailyRefreshEnabled":true,"audienceSize":0,"createdBy":null,"lastRefreshedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z","pausedAt":null},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getAnIntentAudience"},"patch":{"tags":["Audience Builder"],"summary":"Update an intent audience","description":"Updates the name, status, or configuration of an audience owned by the authenticated organization. Activation requires available audience access; pausing stops future automatic refreshes. Configuration updates affect future runs, not previously materialized results.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentAudienceMutationRequest"},"example":{"name":"Example cloud research - paused","status":"paused"}}}},"responses":{"200":{"description":"Updated audience","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudience"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud research - paused","status":"paused","config":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{},"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}]},"accessType":"paid","dailyRefreshEnabled":true,"audienceSize":0,"createdBy":null,"lastRefreshedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z","pausedAt":"2026-01-15T12:00:00.000Z"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid audience config","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApiErrorResponse"},{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"object","properties":{"name":{"type":"string","const":"ZodError"},"message":{"type":"string"}},"required":["name","message"]}},"required":["success","error"]}]}}}},"403":{"description":"Audience access unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Activation conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"updateAnIntentAudience"},"delete":{"tags":["Audience Builder"],"summary":"Delete an intent audience","description":"Deletes an audience owned by the authenticated organization and its associated runs, materialized results, and exports. Export-file cleanup is best effort. A consumed one-shot trial remains consumed after deletion. This action cannot be undone.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"Audience deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeleteResponse"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"11111111-1111-4111-8111-111111111111","deleted":true},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"deleteAnIntentAudience"}},"/v1/intent/audiences/{id}/dashboard":{"get":{"tags":["Audience Builder"],"summary":"Get latest audience movement summary","description":"Compares the latest completed run against the prior completed run and returns compact counts for people added, people removed, intent movement, topic movement, and website visits.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"Audience movement summary with people added, people removed, intent changes, topic changes, and website visits","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceDashboard"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"audience":{"id":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud research","status":"draft","config":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{},"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}]},"accessType":"paid","dailyRefreshEnabled":true,"audienceSize":0,"createdBy":null,"lastRefreshedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z","pausedAt":null},"latestRun":null,"previousRun":null,"state":"no_completed_runs","summary":null},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getLatestAudienceMovementSummary"}},"/v1/intent/audiences/{id}/trends":{"get":{"tags":["Audience Builder"],"summary":"Get audience run trends for charts","description":"Returns chronological per-run metrics and run-over-run movement counts for completed runs.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"integer","minimum":1,"maximum":90,"default":30,"description":"Maximum number of records to return. Defaults to 30; maximum 90.","example":30},"required":false,"description":"Maximum number of records to return. Defaults to 30; maximum 90.","name":"limit","in":"query","example":30}],"responses":{"200":{"description":"Audience run trends for charts","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceTrends"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"audience":{"id":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud research","status":"draft","config":{"topicIds":[1001],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{},"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"}]},"accessType":"paid","dailyRefreshEnabled":true,"audienceSize":0,"createdBy":null,"lastRefreshedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z","pausedAt":null},"latestRun":null,"state":"no_completed_runs","points":[]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getAudienceRunTrendsForCharts"}},"/v1/intent/audiences/{id}/runs":{"post":{"tags":["Audience Builder"],"summary":"Queue an intent audience materialization run","description":"Queues a materialization run for an active audience owned by the authenticated organization. Processing is asynchronous. An existing in-flight run can be returned instead of creating a duplicate; an Idempotency-Key makes retries return the same run.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":120},"description":"Optional client idempotency key. Reusing the same key returns the same run.","example":"example-audience-run-2026-01-15"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIntentAudienceRunRequest"},"example":{"runType":"manual"}}}},"responses":{"202":{"description":"Run queued or existing in-flight run returned","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceRun"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"22222222-2222-4222-8222-222222222222","audienceId":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","status":"queued","runType":"manual","configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","dataDate":"2026-01-15","resultKey":"example-audience-result","candidateCount":0,"resultCount":0,"attempts":0,"nextAttemptAt":null,"idempotencyKey":"example-audience-run-2026-01-15","errorCode":null,"errorMessage":null,"startedAt":null,"completedAt":null,"cancelledAt":null,"readyEmailSentAt":null,"readyEmailExportId":null,"readyEmailError":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"403":{"description":"Audience access unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Audience is not active or free run already used","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"queueAnIntentAudienceMaterializationRun"},"get":{"tags":["Audience Builder"],"summary":"List intent audience runs","description":"Lists runs for an audience owned by the authenticated organization, newest creation first. The limit defaults to 25 and allows up to 100; there is no cursor or offset, and ties in creation time have no guaranteed secondary order. No runs produces an empty list.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Maximum number of records to return. Defaults to 25; maximum 100.","example":25},"required":false,"description":"Maximum number of records to return. Defaults to 25; maximum 100.","name":"limit","in":"query","example":25}],"responses":{"200":{"description":"Audience runs","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceRun"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"examples":{"populated":{"value":{"data":[{"id":"22222222-2222-4222-8222-222222222222","audienceId":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","status":"completed","runType":"manual","configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","dataDate":"2026-01-15","resultKey":"example-audience-result","candidateCount":0,"resultCount":0,"attempts":1,"nextAttemptAt":null,"idempotencyKey":"example-audience-run-2026-01-15","errorCode":null,"errorMessage":null,"startedAt":"2026-01-15T11:59:00.000Z","completedAt":"2026-01-15T12:00:00.000Z","cancelledAt":null,"readyEmailSentAt":null,"readyEmailExportId":null,"readyEmailError":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":[],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"listIntentAudienceRuns"}},"/v1/intent/audiences/{id}/runs/{runId}/results":{"get":{"tags":["Audience Builder"],"summary":"Get hydrated run results","description":"Returns a completed run and its materialized contact results for an audience owned by the authenticated organization. Offset pagination defaults to 100 rows with a maximum of 500, ordered by intent score descending, topic overlap descending, then email hash ascending. Queued or running runs return 202; failed or cancelled runs return a conflict. Previously completed snapshots do not refresh with this request.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Audience run identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Audience run identifier belonging to the selected audience.","name":"runId","in":"path","example":"22222222-2222-4222-8222-222222222222"},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Maximum number of records to return. Defaults to 100; maximum 500.","example":100},"required":false,"description":"Maximum number of records to return. Defaults to 100; maximum 500.","name":"limit","in":"query","example":100},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Zero-based number of matching records to skip.","example":0},"required":false,"description":"Zero-based number of matching records to skip.","name":"offset","in":"query","example":0}],"responses":{"200":{"description":"Completed run results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceResults"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"run":{"id":"22222222-2222-4222-8222-222222222222","audienceId":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","status":"completed","runType":"manual","configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","dataDate":"2026-01-15","resultKey":"example-audience-result","candidateCount":0,"resultCount":0,"attempts":1,"nextAttemptAt":null,"idempotencyKey":"example-audience-run-2026-01-15","errorCode":null,"errorMessage":null,"startedAt":"2026-01-15T11:59:00.000Z","completedAt":"2026-01-15T12:00:00.000Z","cancelledAt":null,"readyEmailSentAt":null,"readyEmailExportId":null,"readyEmailError":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"results":[],"total":0,"limit":100,"offset":0},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"202":{"description":"Run is queued or running","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudiencePendingResults"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"run":{"id":"22222222-2222-4222-8222-222222222222","audienceId":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","status":"queued","runType":"manual","configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","dataDate":"2026-01-15","resultKey":"example-audience-result","candidateCount":0,"resultCount":0,"attempts":0,"nextAttemptAt":null,"idempotencyKey":"example-audience-run-2026-01-15","errorCode":null,"errorMessage":null,"startedAt":null,"completedAt":null,"cancelledAt":null,"readyEmailSentAt":null,"readyEmailExportId":null,"readyEmailError":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"state":"queued","results":[],"total":0,"limit":100,"offset":0},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Run failed or was cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getHydratedRunResults"}},"/v1/intent/audiences/{id}/runs/{runId}":{"delete":{"tags":["Audience Builder"],"summary":"Cancel a queued intent audience run","description":"Cancels a queued run owned by the authenticated organization and returns its updated state. Only queued runs can be cancelled; repeating cancellation or racing with processing returns a conflict.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Audience run identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Audience run identifier belonging to the selected audience.","name":"runId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"Run cancelled","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceRun"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"22222222-2222-4222-8222-222222222222","audienceId":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","status":"cancelled","runType":"manual","configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","dataDate":"2026-01-15","resultKey":"example-audience-result","candidateCount":0,"resultCount":0,"attempts":0,"nextAttemptAt":null,"idempotencyKey":"example-audience-run-2026-01-15","errorCode":null,"errorMessage":null,"startedAt":null,"completedAt":"2026-01-15T12:00:00.000Z","cancelledAt":"2026-01-15T12:00:00.000Z","readyEmailSentAt":null,"readyEmailExportId":null,"readyEmailError":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Run cannot be cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"cancelAQueuedIntentAudienceRun"}},"/v1/intent/audiences/{id}/runs/{runId}/stats":{"get":{"tags":["Audience Builder"],"summary":"Get fill-rate stats for a completed intent audience run","description":"Returns contact-field fill rates and intent-score statistics for a completed run owned by the authenticated organization. A run that is not completed returns a conflict; the statistics describe the stored run snapshot.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Audience run identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Audience run identifier belonging to the selected audience.","name":"runId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"Run fill-rate and score stats","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceRunStatsResponse"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"run":{"id":"22222222-2222-4222-8222-222222222222","audienceId":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","status":"completed","runType":"manual","configHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","dataDate":"2026-01-15","resultKey":"example-audience-result","candidateCount":0,"resultCount":0,"attempts":1,"nextAttemptAt":null,"idempotencyKey":"example-audience-run-2026-01-15","errorCode":null,"errorMessage":null,"startedAt":"2026-01-15T11:59:00.000Z","completedAt":"2026-01-15T12:00:00.000Z","cancelledAt":null,"readyEmailSentAt":null,"readyEmailExportId":null,"readyEmailError":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"stats":{"total":0,"fillRates":{"businessEmail":{"count":0,"percent":0},"personalEmail":{"count":0,"percent":0}},"scoreHistogram":[{"bucket":"50-69","count":0,"percent":0},{"bucket":"70-89","count":0,"percent":0},{"bucket":"90-99","count":0,"percent":0}],"averages":{}}},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Stats are only available for completed runs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getFillRateStatsForACompletedIntentAudienceRun"}},"/v1/intent/audiences/{id}/runs/{runId}/export.csv":{"get":{"tags":["Audience Builder"],"summary":"Download a completed intent audience run as CSV","description":"Streams a CSV of a completed audience run owned by the authenticated organization, capped at 300,000 rows. Response headers report the total result count and whether the export was truncated. Queued, running, failed, or cancelled runs cannot be exported.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Audience run identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Audience run identifier belonging to the selected audience.","name":"runId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"CSV export for a completed run. Export is capped at 300,000 rows.","headers":{"X-ClickHouse-Query-Id":{"schema":{"type":"string"},"description":"ClickHouse query id for export tracing."},"X-Export-Row-Cap":{"schema":{"type":"integer","example":300000},"description":"Maximum rows returned by this CSV export."},"X-Export-Truncated":{"schema":{"type":"string","enum":["true","false"]},"description":"true when result_count is larger than the export cap."},"X-Export-Result-Count":{"schema":{"type":"integer"},"description":"Total materialized rows in the run before the export cap."}},"content":{"text/csv":{"schema":{"type":"string","format":"binary"},"example":"\"hashed_email\",\"profile_pid_all\",\"duplicate_profile_count\",\"source_priority\",\"hem_record_rank\",\"is_best_profile_for_hem\",\"first_name\",\"last_name\",\"full_name\",\"linkedin_url\",\"company_linkedin_url\",\"job_title\",\"headline\",\"role_bucket\",\"seniority_level\",\"department\",\"business_email\",\"personal_email\",\"email\",\"primary_contact_email\",\"phone\",\"mobile_phone\",\"direct_phone\",\"personal_phone\",\"business_email_status\",\"personal_email_status\",\"phone_status\",\"phone_compliance_status\",\"company_name\",\"company_domain\",\"company_domain_tld\",\"company_industry\",\"company_industry_group\",\"company_naics\",\"company_sic\",\"company_description\",\"company_revenue_range\",\"company_city\",\"company_state\",\"company_country\",\"company_zip_code\",\"personal_city\",\"personal_state\",\"personal_state_code\",\"personal_country\",\"personal_country_code\",\"personal_zip\",\"geo_region\",\"gender\",\"age_range\",\"income_range\",\"net_worth\",\"is_ceo\",\"is_cxo\",\"is_c_suite\",\"is_president\",\"is_vp\",\"is_owner_founder\",\"is_partner_principal\",\"is_consultant\",\"is_decision_maker\",\"is_sales\",\"is_marketing\",\"is_revops\",\"is_it\",\"is_security\",\"is_engineering\",\"is_data\",\"is_ai_ml\",\"is_product\",\"is_finance\",\"is_hr\",\"is_legal\",\"is_procurement\",\"is_operations\",\"has_name\",\"has_first_last\",\"has_job_title\",\"has_seniority\",\"has_department\",\"has_linkedin\",\"has_company_linkedin\",\"has_business_email\",\"has_personal_email\",\"has_any_email\",\"has_mobile_phone\",\"has_direct_phone\",\"has_personal_phone\",\"has_any_phone\",\"has_company_phone\",\"has_company_domain\",\"has_company_industry\",\"has_company_revenue\",\"is_contactable\",\"is_business_email_valid\",\"is_personal_email_valid\",\"is_any_email_valid\",\"is_phone_valid\",\"is_email_suppressed\",\"is_domain_suppressed\",\"is_phone_suppressed\",\"is_phone_dnc\",\"is_mobile_dnc\",\"is_direct_dnc\",\"is_personal_phone_dnc\",\"email_is_generic\",\"is_self_employed\",\"is_b2b_profile\",\"is_b2c_profile\",\"is_saas\",\"is_healthcare\",\"is_fintech\",\"is_ecommerce\",\"is_manufacturing\",\"is_real_estate\",\"is_education\",\"is_government\",\"is_retail\",\"is_construction\",\"is_transportation\",\"is_hospitality\",\"is_nonprofit\",\"is_us\",\"build_id\",\"build_date\",\"profile_updated_at\",\"intent_score\",\"topic_overlap\",\"matched_topic_ids\"\n"}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"CSV export is only available for completed runs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"downloadACompletedIntentAudienceRunAsCsv"}},"/v1/intent/audiences/{id}/runs/{runId}/exports":{"post":{"tags":["Audience Builder"],"summary":"Create or reuse a stored CSV export for a completed run","description":"Creates a stored CSV for a completed audience run owned by the authenticated organization, or reuses an existing completed export. Returns export metadata and an expiring signed download URL. A concurrent export already being processed returns a conflict.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Audience run identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Audience run identifier belonging to the selected audience.","name":"runId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"Stored CSV export already exists; fresh signed URL returned","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceExportWithUrl"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"export":{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","runId":"22222222-2222-4222-8222-222222222222","exportType":"csv","status":"completed","storageProvider":"b2","bucketName":"example-exports","fileId":"example-file","fileName":"example-audience.csv","contentType":"text/csv","byteSize":128,"rowCount":0,"contentSha1":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","errorCode":null,"errorMessage":null,"requestedBy":null,"completedAt":"2026-01-15T12:00:00.000Z","expiresAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"downloadUrl":"https://downloads.example.test/example-audience.csv?token=synthetic","downloadUrlExpiresAt":"2026-01-15T13:00:00.000Z","downloadUrlTtlSeconds":3600},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"201":{"description":"Stored CSV export created; signed URL returned","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceExportWithUrl"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"export":{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","runId":"22222222-2222-4222-8222-222222222222","exportType":"csv","status":"completed","storageProvider":"b2","bucketName":"example-exports","fileId":"example-file","fileName":"example-audience.csv","contentType":"text/csv","byteSize":128,"rowCount":0,"contentSha1":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","errorCode":null,"errorMessage":null,"requestedBy":null,"completedAt":"2026-01-15T12:00:00.000Z","expiresAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"downloadUrl":"https://downloads.example.test/example-audience.csv?token=synthetic","downloadUrlExpiresAt":"2026-01-15T13:00:00.000Z","downloadUrlTtlSeconds":3600},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience or run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Run is not completed or export is already processing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"B2 export storage is not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"createOrReuseAStoredCsvExportForACompletedRun"},"get":{"tags":["Audience Builder"],"summary":"List stored exports for a run","description":"Lists stored CSV exports for an audience run owned by the authenticated organization, newest creation first. This unpaginated list is empty when no exports exist; it does not generate files or issue signed download URLs.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Audience run identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Audience run identifier belonging to the selected audience.","name":"runId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"Stored exports for this run","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceExport"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"examples":{"populated":{"value":{"data":[{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","runId":"22222222-2222-4222-8222-222222222222","exportType":"csv","status":"completed","storageProvider":"b2","bucketName":"example-exports","fileId":"example-file","fileName":"example-audience.csv","contentType":"text/csv","byteSize":128,"rowCount":0,"contentSha1":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","errorCode":null,"errorMessage":null,"requestedBy":null,"completedAt":"2026-01-15T12:00:00.000Z","expiresAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":[],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Audience or run not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"listStoredExportsForARun"}},"/v1/intent/audiences/{id}/runs/{runId}/exports/{exportId}":{"get":{"tags":["Audience Builder"],"summary":"Get a stored export and fresh signed download URL","description":"Returns a completed stored export owned by the authenticated organization and a fresh, expiring signed download URL. The audience, run, and export identifiers must belong together. An export that is not completed returns a conflict.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Audience run identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Audience run identifier belonging to the selected audience.","name":"runId","in":"path","example":"22222222-2222-4222-8222-222222222222"},{"schema":{"type":"string","format":"uuid","description":"Stored export identifier belonging to the selected audience and run.","example":"33333333-3333-4333-8333-333333333333"},"required":true,"description":"Stored export identifier belonging to the selected audience and run.","name":"exportId","in":"path","example":"33333333-3333-4333-8333-333333333333"}],"responses":{"200":{"description":"Stored export with a fresh signed download URL","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudienceExportWithUrl"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"export":{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","runId":"22222222-2222-4222-8222-222222222222","exportType":"csv","status":"completed","storageProvider":"b2","bucketName":"example-exports","fileId":"example-file","fileName":"example-audience.csv","contentType":"text/csv","byteSize":128,"rowCount":0,"contentSha1":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","errorCode":null,"errorMessage":null,"requestedBy":null,"completedAt":"2026-01-15T12:00:00.000Z","expiresAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"downloadUrl":"https://downloads.example.test/example-audience.csv?token=synthetic","downloadUrlExpiresAt":"2026-01-15T13:00:00.000Z","downloadUrlTtlSeconds":3600},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Export not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Stored export is not ready","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"B2 export storage is not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getAStoredExportAndFreshSignedDownloadUrl"}},"/v1/intent/topics/lists":{"get":{"tags":["Audience Builder"],"summary":"List saved intent topic lists","description":"Returns saved topic lists owned by the authenticated organization, most recently updated first. The limit defaults to 50 and allows up to 100; there is no cursor or offset, and equal update timestamps have no guaranteed secondary ordering. No saved lists produces an empty list.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50,"description":"Maximum number of records to return. Defaults to 50; maximum 100.","example":50},"required":false,"description":"Maximum number of records to return. Defaults to 50; maximum 100.","name":"limit","in":"query","example":50}],"responses":{"200":{"description":"Saved topic lists","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SavedIntentTopicList"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"examples":{"populated":{"value":{"data":[{"id":"55555555-5555-4555-8555-555555555555","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud topics","topicIds":[1001,1002],"source":"manual","sourceUrl":null,"keywords":[],"createdBy":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":[],"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"listSavedIntentTopicLists"},"post":{"tags":["Audience Builder"],"summary":"Create a saved intent topic list","description":"Saves a named list of 1 to 250 topic identifiers in the authenticated organization. Duplicate topic identifiers are removed and the saved identifiers are sorted numerically. Source metadata is optional, and creating a list does not create an audience.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIntentTopicListRequest"},"example":{"name":"Example cloud topics","topicIds":[1001,1002],"source":"manual"}}}},"responses":{"201":{"description":"Saved topic list created","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SavedIntentTopicList"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"55555555-5555-4555-8555-555555555555","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud topics","topicIds":[1001,1002],"source":"manual","sourceUrl":null,"keywords":[],"createdBy":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid topic list","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApiErrorResponse"},{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"object","properties":{"name":{"type":"string","const":"ZodError"},"message":{"type":"string"}},"required":["name","message"]}},"required":["success","error"]}]}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}},"operationId":"createASavedIntentTopicList"}},"/v1/intent/topics/lists/{id}":{"patch":{"tags":["Audience Builder"],"summary":"Update a saved intent topic list","description":"Updates a saved topic list owned by the authenticated organization. Only supplied fields change; topic identifiers are deduplicated and sorted numerically. Source URL and keywords can be cleared with null. Existing audiences are not rewritten.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Saved topic list identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Saved topic list identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentTopicListMutationRequest"},"example":{"name":"Example cloud topics - revised","topicIds":[1001,1003],"sourceUrl":null}}}},"responses":{"200":{"description":"Saved topic list updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SavedIntentTopicList"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"55555555-5555-4555-8555-555555555555","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud topics - revised","topicIds":[1001,1003],"source":"manual","sourceUrl":null,"keywords":[],"createdBy":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid topic list","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApiErrorResponse"},{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"object","properties":{"name":{"type":"string","const":"ZodError"},"message":{"type":"string"}},"required":["name","message"]}},"required":["success","error"]}]}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Saved topic list not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"updateASavedIntentTopicList"},"delete":{"tags":["Audience Builder"],"summary":"Delete a saved intent topic list","description":"Permanently deletes a saved topic list owned by the authenticated organization. Audiences previously created from the list are not deleted.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Saved topic list identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Saved topic list identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"Saved topic list deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeleteResponse"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"55555555-5555-4555-8555-555555555555","deleted":true},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"404":{"description":"Saved topic list not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"deleteASavedIntentTopicList"}},"/v1/intent/topics/lists/{id}/instantiate":{"post":{"tags":["Audience Builder"],"summary":"Create an audience from a saved topic list","description":"Creates an audience in the authenticated organization from a saved topic list, optionally overriding the name, score thresholds, and filters. The audience defaults to draft and uses the list name when no name is supplied. Active creation requires audience access and counts toward the 50-audience limit; the source list is unchanged.","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"Saved topic list identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Saved topic list identifier within the authenticated organization.","name":"id","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstantiateIntentTopicListRequest"},"example":{"name":"Example cloud audience","status":"draft","minScore":60,"minTopicOverlap":1}}}},"responses":{"201":{"description":"Audience created from topic list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/IntentAudience"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["data","meta"]},"example":{"data":{"id":"11111111-1111-4111-8111-111111111111","organizationId":"33333333-3333-4333-8333-333333333333","name":"Example cloud audience","status":"draft","config":{"topicIds":[1001,1002],"minScore":60,"maxScore":99,"minTopicOverlap":1,"filters":{},"topics":[{"topicId":1001,"topicName":"Example cloud platform","type":"b2b","industry":"Technology","category":"Cloud Computing"},{"topicId":1002,"topicName":"Example cloud storage","type":"b2b","industry":"Technology","category":"Cloud Computing"}]},"accessType":"paid","dailyRefreshEnabled":true,"audienceSize":0,"createdBy":null,"lastRefreshedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z","pausedAt":null},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid audience config","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ApiErrorResponse"},{"type":"object","properties":{"success":{"type":"boolean","const":false},"error":{"type":"object","properties":{"name":{"type":"string","const":"ZodError"},"message":{"type":"string"}},"required":["name","message"]}},"required":["success","error"]}]}}}},"401":{"description":"A valid bearer token or organization API key is required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]},"example":{"error":{"code":"AUTHENTICATION_ERROR","message":"Missing Authorization header or x-api-key"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"403":{"description":"Audience access unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Saved topic list not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Audience limit or activation conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"createAnAudienceFromASavedTopicList"}},"/v1/intent/integrations/apps":{"get":{"tags":["Audience Builder"],"summary":"List Orbit integration apps","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Returns the supported external audience integration apps. Requires a non-viewer organization member using bearer authentication; API keys cannot manage integrations. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","responses":{"200":{"description":"Orbit integration apps","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"apps":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","enum":["emailoctopus"]},"name":{"type":"string"},"category":{"type":"string","enum":["email_marketing"]},"description":{"type":"string"}},"required":["slug","name","category","description"]}}},"required":["apps"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"apps":[{"slug":"emailoctopus","name":"EmailOctopus","category":"email_marketing","description":"Upsert Orbit audience members into an EmailOctopus list"}]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"listOrbitIntegrationApps"}},"/v1/intent/integrations/accounts":{"get":{"tags":["Audience Builder"],"summary":"List connected Orbit integration accounts","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Refreshes connected EmailOctopus accounts for the authenticated organization and returns them most recently updated first. If the provider refresh fails, saved account state is returned. Requires a non-viewer member using bearer authentication; API keys are not allowed. The list is not paginated. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","enum":["emailoctopus"],"description":"Integration app whose connected accounts are returned.","example":"emailoctopus"},"required":false,"description":"Integration app whose connected accounts are returned.","name":"appSlug","in":"query","example":"emailoctopus"}],"responses":{"200":{"description":"Connected accounts","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"pipedreamAccountId":{"type":"string"},"appSlug":{"type":"string","enum":["emailoctopus"]},"appName":{"type":"string"},"accountName":{"type":["string","null"]},"status":{"type":"string","enum":["healthy","unhealthy","disconnected"]},"lastSyncedAt":{"type":"string"}},"required":["id","pipedreamAccountId","appSlug","appName","accountName","status","lastSyncedAt"]}}},"required":["accounts"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"examples":{"populated":{"value":{"data":{"accounts":[{"id":"66666666-6666-4666-8666-666666666666","pipedreamAccountId":"apn_example","appSlug":"emailoctopus","appName":"EmailOctopus","accountName":"Example newsletter","status":"healthy","lastSyncedAt":"2026-01-15T12:00:00.000Z"}]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":{"accounts":[]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"listConnectedOrbitIntegrationAccounts"}},"/v1/intent/integrations/emailoctopus/lists":{"get":{"tags":["Audience Builder"],"summary":"List EmailOctopus lists","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Returns the lists available in a healthy EmailOctopus account owned by the authenticated organization. Requires a non-viewer member using bearer authentication. Provider list order is preserved; the response is not paginated. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Healthy EmailOctopus connected account identifier in the authenticated organization.","example":"66666666-6666-4666-8666-666666666666"},"required":true,"description":"Healthy EmailOctopus connected account identifier in the authenticated organization.","name":"connectedAccountId","in":"query","example":"66666666-6666-4666-8666-666666666666"}],"responses":{"200":{"description":"EmailOctopus lists","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"lists":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceEmailOctopusList"}}},"required":["lists"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"examples":{"populated":{"value":{"data":{"lists":[{"id":"example-newsletter","name":"Example newsletter","doubleOptIn":false,"fields":[{"tag":"FirstName","type":"TEXT","label":"First name","fallback":null}],"tags":["research"],"counts":{"pending":0,"subscribed":12,"unsubscribed":1}}]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":{"lists":[]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"listEmailoctopusLists"}},"/v1/intent/integrations/emailoctopus/lists/{listId}":{"get":{"tags":["Audience Builder"],"summary":"Get an EmailOctopus list and its fields","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Returns one EmailOctopus list, its destination fields, and supported source fields for mapping audience contacts. The connected account must be healthy and owned by the authenticated organization. Requires a non-viewer member using bearer authentication. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","minLength":1,"description":"EmailOctopus list identifier in the connected account.","example":"example-newsletter"},"required":true,"description":"EmailOctopus list identifier in the connected account.","name":"listId","in":"path","example":"example-newsletter"},{"schema":{"type":"string","format":"uuid","description":"Healthy EmailOctopus connected account identifier in the authenticated organization.","example":"66666666-6666-4666-8666-666666666666"},"required":true,"description":"Healthy EmailOctopus connected account identifier in the authenticated organization.","name":"connectedAccountId","in":"query","example":"66666666-6666-4666-8666-666666666666"}],"responses":{"200":{"description":"EmailOctopus list","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"list":{"$ref":"#/components/schemas/IntentAudienceEmailOctopusList"},"sourceFields":{"type":"array","items":{"type":"string","enum":["firstName","lastName","fullName","jobTitle","headline","seniority","department","linkedinUrl","company.name","company.domain","company.industry","company.industryGroup","company.revenueRange","company.linkedinUrl","geo.city","geo.state","geo.country","intent.score","intent.topicOverlap","intent.matchedTopics"]}}},"required":["list","sourceFields"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"list":{"id":"example-newsletter","name":"Example newsletter","doubleOptIn":false,"fields":[{"tag":"FirstName","type":"TEXT","label":"First name","fallback":null}],"tags":["research"],"counts":{"pending":0,"subscribed":12,"unsubscribed":1}},"sourceFields":["firstName","lastName","fullName","jobTitle","headline","seniority","department","linkedinUrl","company.name","company.domain","company.industry","company.industryGroup","company.revenueRange","company.linkedinUrl","geo.city","geo.state","geo.country","intent.score","intent.topicOverlap","intent.matchedTopics"]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"getAnEmailoctopusListAndItsFields"}},"/v1/intent/audiences/{audienceId}/destinations":{"get":{"tags":["Audience Builder"],"summary":"List Orbit audience destinations","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Returns destinations for an audience owned by the authenticated organization, newest creation first. Requires a non-viewer member using bearer authentication. The list is not paginated; no destinations produces an empty list. Webhook signing secrets are omitted. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"responses":{"200":{"description":"Audience destinations","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"destinations":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceDestination"}}},"required":["destinations"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"examples":{"populated":{"value":{"data":{"destinations":[{"id":"22222222-2222-4222-8222-222222222222","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","name":"Example contact webhook","destinationType":"webhook","status":"draft","validationPolicy":"valid_or_catchall","configRevision":1,"approvedConfigHash":null,"lastSuccessfulRunId":null,"initialSyncCompletedAt":null,"stats":{"totalSynced":0,"totalSkipped":0,"totalFailed":0,"consecutiveErrors":0,"lastDeliveredAt":null,"lastErrorCode":null,"lastErrorMessage":null,"lastErrorAt":null},"webhook":{"url":"https://integrations.example.test/intent","signingVersion":"v1","eventTypes":["intent.audience.contact.upserted"],"timeoutMs":10000},"pipedream":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":{"destinations":[]},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"listOrbitAudienceDestinations"},"post":{"tags":["Audience Builder"],"summary":"Create an Orbit audience destination","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Creates a draft webhook or EmailOctopus destination for an audience owned by the authenticated organization. Requires a non-viewer member using bearer authentication. Webhook URLs must resolve to public addresses and subscribe to contact upserts. A new webhook signing secret is returned only in this response. No contacts are delivered until activation. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateIntentAudienceDestination"},"example":{"destinationType":"webhook","name":"Example contact webhook","url":"https://integrations.example.test/intent","eventTypes":["intent.audience.contact.upserted"],"timeoutMs":10000}}}},"responses":{"201":{"description":"Destination created. Webhook secrets are returned only once.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/IntentAudienceDestination"},"webhookSecret":{"type":["string","null"]}},"required":["destination","webhookSecret"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"destination":{"id":"22222222-2222-4222-8222-222222222222","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","name":"Example contact webhook","destinationType":"webhook","status":"draft","validationPolicy":"valid_or_catchall","configRevision":1,"approvedConfigHash":null,"lastSuccessfulRunId":null,"initialSyncCompletedAt":null,"stats":{"totalSynced":0,"totalSkipped":0,"totalFailed":0,"consecutiveErrors":0,"lastDeliveredAt":null,"lastErrorCode":null,"lastErrorMessage":null,"lastErrorAt":null},"webhook":{"url":"https://integrations.example.test/intent","signingVersion":"v1","eventTypes":["intent.audience.contact.upserted"],"timeoutMs":10000},"pipedream":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"webhookSecret":"whsec_example_not_a_real_secret"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"createAnOrbitAudienceDestination"}},"/v1/intent/audiences/{audienceId}/destinations/{destinationId}":{"get":{"tags":["Audience Builder"],"summary":"Get an Orbit audience destination","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Returns a destination belonging to the selected audience and authenticated organization, including configuration and delivery counters but no webhook signing secret. Requires a non-viewer member using bearer authentication. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Destination identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Destination identifier belonging to the selected audience.","name":"destinationId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"Audience destination","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/IntentAudienceDestination"}},"required":["destination"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"destination":{"id":"22222222-2222-4222-8222-222222222222","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","name":"Example contact webhook","destinationType":"webhook","status":"draft","validationPolicy":"valid_or_catchall","configRevision":1,"approvedConfigHash":null,"lastSuccessfulRunId":null,"initialSyncCompletedAt":null,"stats":{"totalSynced":0,"totalSkipped":0,"totalFailed":0,"consecutiveErrors":0,"lastDeliveredAt":null,"lastErrorCode":null,"lastErrorMessage":null,"lastErrorAt":null},"webhook":{"url":"https://integrations.example.test/intent","signingVersion":"v1","eventTypes":["intent.audience.contact.upserted"],"timeoutMs":10000},"pipedream":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"getAnOrbitAudienceDestination"},"patch":{"tags":["Audience Builder"],"summary":"Update or pause an Orbit audience destination","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Updates or pauses a destination belonging to the authenticated organization. Requires a non-viewer member using bearer authentication. Configuration changes reset the delivery baseline; pausing cancels pending deliveries. This operation does not activate a destination. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Destination identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Destination identifier belonging to the selected audience.","name":"destinationId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateIntentAudienceDestination"},"example":{"status":"paused"}}}},"responses":{"200":{"description":"Destination updated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/IntentAudienceDestination"}},"required":["destination"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"destination":{"id":"22222222-2222-4222-8222-222222222222","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","name":"Example contact webhook","destinationType":"webhook","status":"paused","validationPolicy":"valid_or_catchall","configRevision":1,"approvedConfigHash":null,"lastSuccessfulRunId":null,"initialSyncCompletedAt":null,"stats":{"totalSynced":0,"totalSkipped":0,"totalFailed":0,"consecutiveErrors":0,"lastDeliveredAt":null,"lastErrorCode":null,"lastErrorMessage":null,"lastErrorAt":null},"webhook":{"url":"https://integrations.example.test/intent","signingVersion":"v1","eventTypes":["intent.audience.contact.upserted"],"timeoutMs":10000},"pipedream":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"updateOrPauseAnOrbitAudienceDestination"},"delete":{"tags":["Audience Builder"],"summary":"Delete an Orbit audience destination","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Permanently deletes a destination owned by the authenticated organization after cancelling pending deliveries. Requires a non-viewer member using bearer authentication. This does not delete the source audience or remove contacts already sent to the external service. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Destination identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Destination identifier belonging to the selected audience.","name":"destinationId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"Destination deleted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean","enum":[true]}},"required":["id","deleted"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"id":"22222222-2222-4222-8222-222222222222","deleted":true},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"deleteAnOrbitAudienceDestination"}},"/v1/intent/audiences/{audienceId}/destinations/{destinationId}/activate":{"post":{"tags":["Audience Builder"],"summary":"Activate an Orbit audience destination","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Activates a destination and approves the current audience definition for delivery. Requires a non-viewer member using bearer authentication and an organization eligible for delivery. With syncCurrent true, the latest completed matching audience run is scheduled for delivery when available; the returned delivery is null otherwise. Provider configuration is verified before activation. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Destination identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Destination identifier belonging to the selected audience.","name":"destinationId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateIntentAudienceDestination"},"example":{"syncCurrent":true}}}},"responses":{"200":{"description":"Destination activated","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"destination":{"$ref":"#/components/schemas/IntentAudienceDestination"},"delivery":{"$ref":"#/components/schemas/IntentAudienceDelivery"}},"required":["destination","delivery"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"destination":{"id":"22222222-2222-4222-8222-222222222222","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","name":"Example contact webhook","destinationType":"webhook","status":"active","validationPolicy":"valid_or_catchall","configRevision":1,"approvedConfigHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","lastSuccessfulRunId":null,"initialSyncCompletedAt":null,"stats":{"totalSynced":0,"totalSkipped":0,"totalFailed":0,"consecutiveErrors":0,"lastDeliveredAt":null,"lastErrorCode":null,"lastErrorMessage":null,"lastErrorAt":null},"webhook":{"url":"https://integrations.example.test/intent","signingVersion":"v1","eventTypes":["intent.audience.contact.upserted"],"timeoutMs":10000},"pipedream":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"delivery":{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","destinationId":"22222222-2222-4222-8222-222222222222","destinationConfigRevision":1,"sourceRunId":"55555555-5555-4555-8555-555555555555","baselineRunId":null,"mode":"initial","status":"queued","sourceCount":12,"processedCount":0,"sentCount":0,"skippedCount":0,"failedCount":0,"batchIndex":0,"attempts":0,"nextAttemptAt":null,"errorCode":null,"errorMessage":null,"startedAt":null,"completedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"activateAnOrbitAudienceDestination"}},"/v1/intent/audiences/{audienceId}/destinations/{destinationId}/sync":{"post":{"tags":["Audience Builder"],"summary":"Queue an Orbit audience destination sync","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Schedules delivery of the latest completed audience run to an active destination owned by the authenticated organization. Requires a non-viewer member using bearer authentication and delivery eligibility. Incremental mode sends changes; full_resync requests the full snapshot. Processing is asynchronous. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Destination identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Destination identifier belonging to the selected audience.","name":"destinationId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncIntentAudienceDestination"},"example":{"mode":"incremental"}}}},"responses":{"202":{"description":"Delivery queued","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"delivery":{"$ref":"#/components/schemas/IntentAudienceDelivery"}},"required":["delivery"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"delivery":{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","destinationId":"22222222-2222-4222-8222-222222222222","destinationConfigRevision":1,"sourceRunId":"55555555-5555-4555-8555-555555555555","baselineRunId":null,"mode":"initial","status":"queued","sourceCount":12,"processedCount":0,"sentCount":0,"skippedCount":0,"failedCount":0,"batchIndex":0,"attempts":0,"nextAttemptAt":null,"errorCode":null,"errorMessage":null,"startedAt":null,"completedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"queueAnOrbitAudienceDestinationSync"}},"/v1/intent/audiences/{audienceId}/destinations/{destinationId}/test":{"post":{"tags":["Audience Builder"],"summary":"Test an Orbit audience destination without syncing contacts","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Checks an organization-owned destination without syncing audience contacts. Requires a non-viewer member using bearer authentication and delivery eligibility. Webhook destinations receive a synthetic test event; EmailOctopus destinations have their account and list checked. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Destination identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Destination identifier belonging to the selected audience.","name":"destinationId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"Destination test succeeded","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"delivered":{"type":"boolean"},"message":{"type":"string"}},"required":["delivered","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"delivered":true,"message":"Test webhook delivered"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"testAnOrbitAudienceDestinationWithoutSyncingContacts"}},"/v1/intent/audiences/{audienceId}/destinations/{destinationId}/rotate-secret":{"post":{"tags":["Audience Builder"],"summary":"Rotate an Orbit webhook signing secret","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Replaces the signing secret for a paused or draft webhook destination owned by the authenticated organization. Requires a non-viewer member using bearer authentication. The new secret is returned once and replaces the previous secret immediately. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Destination identifier belonging to the selected audience.","example":"22222222-2222-4222-8222-222222222222"},"required":true,"description":"Destination identifier belonging to the selected audience.","name":"destinationId","in":"path","example":"22222222-2222-4222-8222-222222222222"}],"responses":{"200":{"description":"Secret rotated and returned once","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"secret":{"type":"string"}},"required":["secret"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"secret":"whsec_example_not_a_real_secret"},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"rotateAnOrbitWebhookSigningSecret"}},"/v1/intent/audiences/{audienceId}/deliveries":{"get":{"tags":["Audience Builder"],"summary":"List Orbit audience deliveries","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Returns deliveries for an audience owned by the authenticated organization, newest creation first, with a total count. Requires a non-viewer member using bearer authentication. Offset pagination defaults to 25 rows and allows at most 100. Equal creation timestamps have no guaranteed secondary order; an empty page returns an empty deliveries array. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Maximum deliveries to return; defaults to 25 and allows up to 100.","example":25},"required":false,"description":"Maximum deliveries to return; defaults to 25 and allows up to 100.","name":"limit","in":"query","example":25},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Zero-based number of deliveries to skip.","example":0},"required":false,"description":"Zero-based number of deliveries to skip.","name":"offset","in":"query","example":0}],"responses":{"200":{"description":"Audience deliveries","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"deliveries":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceDelivery"}},"total":{"type":"integer"}},"required":["deliveries","total"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"examples":{"populated":{"value":{"data":{"deliveries":[{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","destinationId":"22222222-2222-4222-8222-222222222222","destinationConfigRevision":1,"sourceRunId":"55555555-5555-4555-8555-555555555555","baselineRunId":null,"mode":"initial","status":"queued","sourceCount":12,"processedCount":0,"sentCount":0,"skippedCount":0,"failedCount":0,"batchIndex":0,"attempts":0,"nextAttemptAt":null,"errorCode":null,"errorMessage":null,"startedAt":null,"completedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}],"total":1},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}},"empty":{"value":{"data":{"deliveries":[],"total":0},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"listOrbitAudienceDeliveries"}},"/v1/intent/audiences/{audienceId}/deliveries/{deliveryId}":{"get":{"tags":["Audience Builder"],"summary":"Get an Orbit audience delivery","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Returns an organization-owned delivery and a paginated list of failed or skipped members. Requires a non-viewer member using bearer authentication. Failure pagination defaults to 25 rows and allows at most 100; failures are ordered by creation time then identifier, both descending. Member email addresses are represented by hashes. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Delivery identifier belonging to the selected audience.","example":"44444444-4444-4444-8444-444444444444"},"required":true,"description":"Delivery identifier belonging to the selected audience.","name":"deliveryId","in":"path","example":"44444444-4444-4444-8444-444444444444"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Maximum failure records to return; defaults to 25 and allows up to 100.","example":25},"required":false,"description":"Maximum failure records to return; defaults to 25 and allows up to 100.","name":"failureLimit","in":"query","example":25},{"schema":{"type":["integer","null"],"minimum":0,"default":0,"description":"Zero-based number of failure records to skip.","example":0},"required":false,"description":"Zero-based number of failure records to skip.","name":"failureOffset","in":"query","example":0}],"responses":{"200":{"description":"Audience delivery","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"delivery":{"$ref":"#/components/schemas/IntentAudienceDelivery"},"failures":{"type":"array","items":{"type":"object","properties":{"memberHash":{"type":"string"},"status":{"type":"string","enum":["skipped","failed"]},"errorCode":{"type":"string"},"errorMessage":{"type":["string","null"]},"attempts":{"type":"integer"}},"required":["memberHash","status","errorCode","errorMessage","attempts"]}},"failuresTotal":{"type":"integer"}},"required":["delivery","failures","failuresTotal"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"delivery":{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","destinationId":"22222222-2222-4222-8222-222222222222","destinationConfigRevision":1,"sourceRunId":"55555555-5555-4555-8555-555555555555","baselineRunId":null,"mode":"initial","status":"partial","sourceCount":12,"processedCount":12,"sentCount":11,"skippedCount":0,"failedCount":1,"batchIndex":0,"attempts":0,"nextAttemptAt":null,"errorCode":null,"errorMessage":null,"startedAt":null,"completedAt":"2026-01-15T12:00:00.000Z","createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"},"failures":[{"memberHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","status":"failed","errorCode":"EXAMPLE_PROVIDER_REJECTION","errorMessage":"Synthetic provider rejection","attempts":1}],"failuresTotal":1},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"getAnOrbitAudienceDelivery"}},"/v1/intent/audiences/{audienceId}/deliveries/{deliveryId}/retry":{"post":{"tags":["Audience Builder"],"summary":"Retry a failed or partial Orbit audience delivery","security":[{"bearerAuth":[]},{"apiKeyAuth":[]}],"description":"Retries a failed or partial delivery owned by the authenticated organization and reactivates its destination. Requires a non-viewer member using bearer authentication and delivery eligibility. The source snapshot must remain completed and unexpired, and its configuration must still match the approved destination. Processing is asynchronous. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.","parameters":[{"schema":{"type":"string","format":"uuid","description":"Audience identifier within the authenticated organization.","example":"11111111-1111-4111-8111-111111111111"},"required":true,"description":"Audience identifier within the authenticated organization.","name":"audienceId","in":"path","example":"11111111-1111-4111-8111-111111111111"},{"schema":{"type":"string","format":"uuid","description":"Delivery identifier belonging to the selected audience.","example":"44444444-4444-4444-8444-444444444444"},"required":true,"description":"Delivery identifier belonging to the selected audience.","name":"deliveryId","in":"path","example":"44444444-4444-4444-8444-444444444444"}],"responses":{"202":{"description":"Delivery queued for retry","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"delivery":{"$ref":"#/components/schemas/IntentAudienceDelivery"}},"required":["delivery"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"example":{"data":{"delivery":{"id":"44444444-4444-4444-8444-444444444444","organizationId":"33333333-3333-4333-8333-333333333333","audienceId":"11111111-1111-4111-8111-111111111111","destinationId":"22222222-2222-4222-8222-222222222222","destinationConfigRevision":1,"sourceRunId":"55555555-5555-4555-8555-555555555555","baselineRunId":null,"mode":"initial","status":"queued","sourceCount":12,"processedCount":0,"sentCount":0,"skippedCount":0,"failedCount":0,"batchIndex":0,"attempts":1,"nextAttemptAt":null,"errorCode":null,"errorMessage":null,"startedAt":null,"completedAt":null,"createdAt":"2026-01-15T12:00:00.000Z","updatedAt":"2026-01-15T12:00:00.000Z"}},"meta":{"timestamp":"2026-01-15T12:00:00.000Z","request_id":"example-request"}}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"403":{"description":"Not allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"500":{"description":"Provider or internal failure","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}},"503":{"description":"Required integration configuration unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["error","meta"]}}}}},"operationId":"retryAFailedOrPartialOrbitAudienceDelivery"}}},"tags":[{"name":"Topic Discovery","description":"Browse, search, and analyze available intent topics"},{"name":"Site Analysis","description":"Analyze a website URL to find matching intent topics"},{"name":"Site Topics","description":"Recent organization site-topic analyses"},{"name":"Audience Builder","description":"Curated filters, preview, saved audiences, runs, exports, webhooks, and managed destinations"}],"components":{"schemas":{"SiteTopicsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"company":{"type":["string","null"]},"summary":{"type":["string","null"]},"keywords":{"type":"array","items":{"type":"string"}},"contentHash":{"type":"string","description":"SHA-256 hash of the analyzed site text. Older cached analysis results may omit this field."},"topics":{"type":"array","items":{"type":"object","properties":{"topicId":{"type":"number"},"topicName":{"type":"string"},"type":{"type":"string"},"industry":{"type":"string"},"category":{"type":"string"},"similarity":{"type":"number"},"matchedKeyword":{"type":"string"}},"required":["topicId","topicName","type","industry","category","similarity","matchedKeyword"]}}},"required":["company","summary","keywords","topics"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"RecentSearchesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string"},"company":{"type":["string","null"]},"summary":{"type":["string","null"]},"topicCount":{"type":"number"},"keywords":{"type":["array","null"],"items":{"type":"string"}},"topTopics":{"type":["array","null"],"items":{"type":"object","properties":{"topicId":{"type":"number"},"topicName":{"type":"string"},"type":{"type":"string"},"industry":{"type":"string"},"similarity":{"type":"number"}},"required":["topicId","topicName","type","industry","similarity"]}},"createdAt":{"type":"string"}},"required":["id","url","company","summary","topicCount","keywords","topTopics","createdAt"]}},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"AudienceFilterCatalogResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"version":{"type":"object","properties":{"status":{"type":"string","enum":["catalog","static_fallback"]},"sourceTable":{"type":"string"},"catalogTable":{"type":"string"},"catalogVersion":{"type":["string","null"]},"buildId":{"type":["string","null"]},"buildDate":{"type":["string","null"]},"generatedAt":{"type":["string","null"]}},"required":["status","sourceTable","catalogTable","catalogVersion","buildId","buildDate","generatedAt"]},"summary":{"type":"object","properties":{"groupCount":{"type":"number"},"filterCount":{"type":"number"},"valueCount":{"type":"number"},"recommendedFilterCount":{"type":"number"},"standardFilterCount":{"type":"number"},"advancedFilterCount":{"type":"number"},"supportsAdvancedLogic":{"type":"boolean"},"defaultFieldLogic":{"type":"string","enum":["and"]}},"required":["groupCount","filterCount","valueCount","recommendedFilterCount","standardFilterCount","advancedFilterCount","supportsAdvancedLogic","defaultFieldLogic"]},"logic":{"type":"object","properties":{"summary":{"type":"string"},"uiHints":{"type":"object","properties":{"useFields":{"type":"array","items":{"type":"string"}},"technicalFields":{"type":"array","items":{"type":"string"}},"valueHint":{"type":"string"}},"required":["useFields","technicalFields","valueHint"]},"simpleFilters":{"type":"object","properties":{"shape":{"type":"string"},"topLevelLogic":{"type":"string"},"multiSelectValueLogic":{"type":"string"},"textTermLogic":{"type":"string"}},"required":["shape","topLevelLogic","multiSelectValueLogic","textTermLogic"]},"advancedFilters":{"type":"object","properties":{"enabled":{"type":"boolean"},"keys":{"type":"array","items":{"type":"string","enum":["and","or"]}},"conditionShape":{"type":"string"},"rules":{"type":"array","items":{"type":"string"}}},"required":["enabled","keys","conditionShape","rules"]},"examples":{"type":"object","properties":{"simple":{"type":"object","additionalProperties":{}},"or":{"type":"object","additionalProperties":{}},"nested":{"type":"object","additionalProperties":{}}},"required":["simple","or","nested"]}},"required":["summary","uiHints","simpleFilters","advancedFilters","examples"]},"groups":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"filters":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"type":{"type":"string","enum":["multi_select","boolean","text_terms","number_range"]},"valueType":{"type":"string","enum":["enum","boolean","string","number"]},"operators":{"type":"array","items":{"type":"string"}},"sourceColumn":{"type":"string"},"source":{"type":"string","enum":["serving","filter_surface","both"]},"requiresSidecar":{"type":"boolean"},"isSearchOnly":{"type":"boolean"},"maxValues":{"type":"number"},"maxTerms":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"ui":{"type":"object","properties":{"label":{"type":"string"},"description":{"type":"string"},"control":{"type":"string","enum":["multi_select","toggle","text_chips","number_range"]},"section":{"type":"string","enum":["recommended","standard","advanced"]},"order":{"type":"number"},"recommended":{"type":"boolean"},"advanced":{"type":"boolean"},"placeholder":{"type":"string"},"helperText":{"type":"string"},"examples":{"type":"array","items":{"type":"string"}},"valueLabelStyle":{"type":"string","enum":["title","code","range","grade"]},"allowCustomValues":{"type":"boolean"}},"required":["label","description","control","section","order","recommended","advanced"]},"values":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"count":{"type":"number"}},"required":["value","label","count"]}}},"required":["key","label","type","valueType","operators","sourceColumn","source","requiresSidecar","isSearchOnly","ui"]}}},"required":["key","label","description","filters"]}}},"required":["version","summary","logic","groups"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"TopicInventoryResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"topicId":{"type":"number"},"topicName":{"type":"string"},"type":{"type":"string"},"industry":{"type":"string"},"category":{"type":"string"}},"required":["topicId","topicName","type","industry","category"]}},"meta":{"type":"object","properties":{"count":{"type":"number","description":"Number of topics matching the supplied filters."},"total":{"type":"number","description":"Number of topics in the catalog before filters."},"filters":{"type":"object","properties":{"type":{"type":["string","null"]},"industry":{"type":["string","null"]},"category":{"type":["string","null"]},"q":{"type":["string","null"]}},"required":["type","industry","category","q"]}},"required":["count","total","filters"]}},"required":["data","meta"]},"TopicInventoryFacetsResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"types":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"number"}},"required":["value","count"]}},"industries":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"number"}},"required":["value","count"]}},"categories":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"number"}},"required":["value","count"]}},"total":{"type":"number","description":"Total number of topics in the unfiltered catalog."}},"required":["types","industries","categories","total"]},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"TopicSearchResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"topicId":{"type":"number"},"topicName":{"type":"string"},"type":{"type":"string"},"industry":{"type":"string"},"category":{"type":"string"}},"required":["topicId","topicName","type","industry","category"]}},"meta":{"type":"object","properties":{"timestamp":{"type":"string"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]}},"required":["data","meta"]},"IntentAudiencePreviewRequest":{"type":"object","properties":{"topicIds":{"type":"array","items":{"type":"integer","exclusiveMinimum":0},"minItems":1,"maxItems":250,"example":[1001,1002]},"minScore":{"type":["integer","null"],"minimum":0,"maximum":99,"example":50,"description":"Minimum intent score. Values below 50 are accepted and normalized to 50."},"maxScore":{"type":"integer","minimum":50,"maximum":99,"example":99},"minTopicOverlap":{"type":"integer","minimum":1,"maximum":250,"example":1},"filters":{"type":"object","additionalProperties":{},"example":{"role":{"isDecisionMaker":true},"contact":{"hasBusinessEmail":true},"jobTitle":{"include":["chief financial officer","cfo"],"includeMode":"any"}}},"sourceUrl":{"type":"string","format":"uri","example":"https://cloud.example.test"}},"required":["topicIds"]},"CreateIntentAudienceRequest":{"allOf":[{"$ref":"#/components/schemas/IntentAudienceMutationRequest"},{"type":"object","properties":{},"required":["name","config"]}]},"IntentAudienceMutationRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160,"example":"Finance decision makers researching AI"},"status":{"type":"string","enum":["draft","active","paused"],"example":"draft"},"config":{"$ref":"#/components/schemas/IntentAudienceConfig"}}},"CreateIntentAudienceRunRequest":{"type":"object","properties":{"runType":{"type":"string","enum":["manual"],"default":"manual","example":"manual","description":"Public run creation only supports manual runs. Daily refresh runs are scheduled automatically."}}},"CreateIntentTopicListRequest":{"allOf":[{"$ref":"#/components/schemas/IntentTopicListMutationRequest"},{"type":"object","properties":{},"required":["name","topicIds"]}]},"IntentTopicListMutationRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"topicIds":{"type":"array","items":{"type":"integer","exclusiveMinimum":0},"minItems":1,"maxItems":250},"source":{"type":"string","enum":["site_analysis","search","manual"]},"sourceUrl":{"type":["string","null"],"format":"uri"},"keywords":{"type":["array","null"],"items":{"type":"string","minLength":1,"maxLength":120},"maxItems":100}}},"InstantiateIntentTopicListRequest":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"status":{"type":"string","enum":["draft","active"],"default":"draft"},"filters":{"type":"object","additionalProperties":{}},"minScore":{"type":["integer","null"],"minimum":0,"maximum":99},"maxScore":{"type":"integer","minimum":50,"maximum":99},"minTopicOverlap":{"type":"integer","minimum":1,"maximum":250}}},"IntentAudienceEmailOctopusList":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"doubleOptIn":{"type":"boolean"},"fields":{"type":"array","items":{"type":"object","properties":{"tag":{"type":"string"},"type":{"type":"string","enum":["TEXT","NUMBER","DATE"]},"label":{"type":"string"},"fallback":{"type":["string","null"]}},"required":["tag","type","label"]}},"tags":{"type":"array","items":{"type":"string"}},"counts":{"type":"object","properties":{"pending":{"type":"integer"},"subscribed":{"type":"integer"},"unsubscribed":{"type":"integer"}},"required":["pending","subscribed","unsubscribed"]}},"required":["id","name","doubleOptIn","fields","tags","counts"]},"IntentAudienceDestination":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"audienceId":{"type":"string","format":"uuid"},"name":{"type":"string"},"destinationType":{"type":"string","enum":["webhook","pipedream"]},"status":{"type":"string","enum":["draft","active","paused","needs_attention"]},"validationPolicy":{"type":"string","enum":["none","valid_or_catchall"]},"configRevision":{"type":"integer","exclusiveMinimum":0},"approvedConfigHash":{"type":["string","null"]},"lastSuccessfulRunId":{"type":["string","null"],"format":"uuid"},"initialSyncCompletedAt":{"type":["string","null"]},"stats":{"type":"object","properties":{"totalSynced":{"type":"integer"},"totalSkipped":{"type":"integer"},"totalFailed":{"type":"integer"},"consecutiveErrors":{"type":"integer"},"lastDeliveredAt":{"type":["string","null"]},"lastErrorCode":{"type":["string","null"]},"lastErrorMessage":{"type":["string","null"]},"lastErrorAt":{"type":["string","null"]}},"required":["totalSynced","totalSkipped","totalFailed","consecutiveErrors","lastDeliveredAt","lastErrorCode","lastErrorMessage","lastErrorAt"]},"webhook":{"type":["object","null"],"properties":{"url":{"type":"string","format":"uri"},"signingVersion":{"type":"string","enum":["v1"]},"eventTypes":{"type":"array","items":{"type":"string","enum":["intent.audience.sync.started","intent.audience.contact.upserted","intent.audience.sync.completed"]}},"timeoutMs":{"type":"integer"}},"required":["url","signingVersion","eventTypes","timeoutMs"]},"pipedream":{"type":["object","null"],"properties":{"appSlug":{"type":"string","enum":["emailoctopus"]},"connectedAccount":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"pipedreamAccountId":{"type":"string"},"appSlug":{"type":"string","enum":["emailoctopus"]},"appName":{"type":"string"},"accountName":{"type":["string","null"]},"status":{"type":"string","enum":["healthy","unhealthy","disconnected"]},"lastSyncedAt":{"type":"string"}},"required":["id","pipedreamAccountId","appSlug","appName","accountName","status","lastSyncedAt"]},"config":{"type":"object","properties":{"listId":{"type":"string"},"listName":{"type":"string"},"emailSource":{"type":"string","enum":["email"]},"newContactStatus":{"type":"string","enum":["SUBSCRIBED"]},"fieldMapping":{"type":"object","additionalProperties":{"type":"string","enum":["firstName","lastName","fullName","jobTitle","headline","seniority","department","linkedinUrl","company.name","company.domain","company.industry","company.industryGroup","company.revenueRange","company.linkedinUrl","geo.city","geo.state","geo.country","intent.score","intent.topicOverlap","intent.matchedTopics"]}},"tags":{"type":"array","items":{"type":"string"}}},"required":["listId","emailSource","newContactStatus"]}},"required":["appSlug","connectedAccount","config"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","organizationId","audienceId","name","destinationType","status","validationPolicy","configRevision","approvedConfigHash","lastSuccessfulRunId","initialSyncCompletedAt","stats","webhook","pipedream","createdAt","updatedAt"]},"CreateIntentAudienceDestination":{"oneOf":[{"type":"object","properties":{"destinationType":{"type":"string","enum":["webhook"]},"name":{"type":"string","minLength":1,"maxLength":160},"url":{"type":"string","format":"uri"},"eventTypes":{"type":"array","items":{"type":"string","enum":["intent.audience.sync.started","intent.audience.contact.upserted","intent.audience.sync.completed"]},"minItems":1},"timeoutMs":{"type":"integer","minimum":1000,"maximum":30000,"default":10000}},"required":["destinationType","name","url"]},{"type":"object","properties":{"destinationType":{"type":"string","enum":["pipedream"]},"name":{"type":"string","minLength":1,"maxLength":160},"connectedAccountId":{"type":"string","format":"uuid"},"appSlug":{"type":"string","enum":["emailoctopus"]},"config":{"type":"object","properties":{"listId":{"type":"string","minLength":1,"maxLength":200},"listName":{"type":"string","maxLength":200},"emailSource":{"type":"string","enum":["email"],"default":"email"},"newContactStatus":{"type":"string","enum":["SUBSCRIBED"],"default":"SUBSCRIBED"},"fieldMapping":{"type":"object","additionalProperties":{"type":"string","enum":["firstName","lastName","fullName","jobTitle","headline","seniority","department","linkedinUrl","company.name","company.domain","company.industry","company.industryGroup","company.revenueRange","company.linkedinUrl","geo.city","geo.state","geo.country","intent.score","intent.topicOverlap","intent.matchedTopics"]}},"tags":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":19}},"required":["listId"]}},"required":["destinationType","name","connectedAccountId","appSlug","config"]}]},"UpdateIntentAudienceDestination":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":160},"status":{"type":"string","enum":["draft","paused"]},"webhook":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"eventTypes":{"type":"array","items":{"type":"string","enum":["intent.audience.sync.started","intent.audience.contact.upserted","intent.audience.sync.completed"]},"minItems":1},"timeoutMs":{"type":"integer","minimum":1000,"maximum":30000}}},"emailOctopus":{"type":"object","properties":{"listId":{"type":"string","minLength":1,"maxLength":200},"listName":{"type":"string","maxLength":200},"emailSource":{"type":"string","enum":["email"],"default":"email"},"newContactStatus":{"type":"string","enum":["SUBSCRIBED"],"default":"SUBSCRIBED"},"fieldMapping":{"type":"object","additionalProperties":{"type":"string","enum":["firstName","lastName","fullName","jobTitle","headline","seniority","department","linkedinUrl","company.name","company.domain","company.industry","company.industryGroup","company.revenueRange","company.linkedinUrl","geo.city","geo.state","geo.country","intent.score","intent.topicOverlap","intent.matchedTopics"]}},"tags":{"type":"array","items":{"type":"string","minLength":1,"maxLength":100},"maxItems":19},"connectedAccountId":{"type":"string","format":"uuid"}}}}},"ActivateIntentAudienceDestination":{"type":"object","properties":{"syncCurrent":{"type":"boolean","default":true}}},"IntentAudienceDelivery":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"audienceId":{"type":"string","format":"uuid"},"destinationId":{"type":"string","format":"uuid"},"destinationConfigRevision":{"type":"integer","exclusiveMinimum":0},"sourceRunId":{"type":"string","format":"uuid"},"baselineRunId":{"type":["string","null"],"format":"uuid"},"mode":{"type":"string","enum":["initial","incremental","full_resync"]},"status":{"type":"string","enum":["queued","running","completed","partial","failed","cancelled"]},"sourceCount":{"type":"integer"},"processedCount":{"type":"integer"},"sentCount":{"type":"integer"},"skippedCount":{"type":"integer"},"failedCount":{"type":"integer"},"batchIndex":{"type":"integer"},"attempts":{"type":"integer"},"nextAttemptAt":{"type":["string","null"]},"errorCode":{"type":["string","null"]},"errorMessage":{"type":["string","null"]},"startedAt":{"type":["string","null"]},"completedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","organizationId","audienceId","destinationId","destinationConfigRevision","sourceRunId","baselineRunId","mode","status","sourceCount","processedCount","sentCount","skippedCount","failedCount","batchIndex","attempts","nextAttemptAt","errorCode","errorMessage","startedAt","completedAt","createdAt","updatedAt"]},"SyncIntentAudienceDestination":{"type":"object","properties":{"mode":{"type":"string","enum":["incremental","full_resync"]}}},"ApiMeta":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time"},"request_id":{"type":"string"}},"required":["timestamp","request_id"]},"ApiError":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]},"ApiErrorResponse":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/ApiError"},"meta":{"$ref":"#/components/schemas/ApiMeta"}},"required":["error","meta"]},"IntentAudienceConfig":{"type":"object","properties":{"topicIds":{"type":"array","items":{"type":"integer"},"minItems":1,"maxItems":250},"minScore":{"type":"integer","minimum":0,"maximum":99,"description":"Accepted below 50, normalized/clamped to 50 by the backend."},"maxScore":{"type":"integer","minimum":50,"maximum":99,"default":99},"minTopicOverlap":{"type":"integer","minimum":1,"maximum":250,"default":1},"filters":{"type":"object","additionalProperties":true},"sourceUrl":{"type":"string","format":"uri"},"topics":{"type":"array","items":{"$ref":"#/components/schemas/IntentMatchedTopic"},"description":"Hydrated topic metadata for display. Present on audience responses; write requests should continue sending topicIds."}},"required":["topicIds"]},"IntentAudience":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","active","paused"]},"config":{"$ref":"#/components/schemas/IntentAudienceResponseConfig"},"accessType":{"type":"string","enum":["paid","free_one_shot"]},"dailyRefreshEnabled":{"type":"boolean"},"audienceSize":{"type":"integer"},"createdBy":{"type":["string","null"],"format":"uuid"},"lastRefreshedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"},"pausedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","organizationId","name","status","config","accessType","dailyRefreshEnabled","audienceSize"]},"IntentAudienceRun":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"audienceId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["queued","running","completed","failed","cancelled"]},"runType":{"type":"string","enum":["manual","daily","preview"]},"configHash":{"type":"string"},"dataDate":{"type":"string","format":"date"},"resultKey":{"type":"string"},"candidateCount":{"type":"integer"},"resultCount":{"type":"integer"},"attempts":{"type":"integer"},"nextAttemptAt":{"type":["string","null"],"format":"date-time"},"idempotencyKey":{"type":["string","null"]},"errorCode":{"type":["string","null"]},"errorMessage":{"type":["string","null"]},"startedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"cancelledAt":{"type":["string","null"],"format":"date-time"},"readyEmailSentAt":{"type":["string","null"],"format":"date-time"},"readyEmailExportId":{"type":["string","null"],"format":"uuid"},"readyEmailError":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","audienceId","organizationId","status","runType","configHash","dataDate","resultKey","candidateCount","resultCount","attempts"]},"IntentAudienceExport":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"audienceId":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"exportType":{"type":"string","enum":["csv"]},"status":{"type":"string","enum":["processing","completed","failed"]},"storageProvider":{"type":"string","enum":["b2"]},"bucketName":{"type":["string","null"]},"fileId":{"type":["string","null"]},"fileName":{"type":["string","null"]},"contentType":{"type":"string"},"byteSize":{"type":"integer"},"rowCount":{"type":"integer"},"contentSha1":{"type":["string","null"]},"errorCode":{"type":["string","null"]},"errorMessage":{"type":["string","null"]},"requestedBy":{"type":["string","null"],"format":"uuid"},"completedAt":{"type":["string","null"],"format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","organizationId","audienceId","runId","exportType","status","storageProvider","contentType","byteSize","rowCount"]},"IntentAudienceExportWithUrl":{"type":"object","properties":{"export":{"$ref":"#/components/schemas/IntentAudienceExport"},"downloadUrl":{"type":["string","null"],"format":"uri"},"downloadUrlExpiresAt":{"type":["string","null"],"format":"date-time"},"downloadUrlTtlSeconds":{"type":["integer","null"]}},"required":["export","downloadUrl","downloadUrlExpiresAt","downloadUrlTtlSeconds"]},"SavedIntentTopicList":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"name":{"type":"string"},"topicIds":{"type":"array","items":{"type":"integer"},"minItems":1,"maxItems":250},"source":{"type":"string","enum":["site_analysis","search","manual"]},"sourceUrl":{"type":["string","null"],"format":"uri"},"keywords":{"type":"array","items":{"type":"string"}},"createdBy":{"type":["string","null"],"format":"uuid"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","organizationId","name","topicIds","source","keywords"]},"AudienceBreakdownBucket":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer"}},"required":["value","label","count"]},"AudiencePreviewBreakdowns":{"type":"object","properties":{"industries":{"type":"array","items":{"$ref":"#/components/schemas/AudienceBreakdownBucket"}},"seniorities":{"type":"array","items":{"$ref":"#/components/schemas/AudienceBreakdownBucket"}},"departments":{"type":"array","items":{"$ref":"#/components/schemas/AudienceBreakdownBucket"}},"companySizes":{"type":"array","items":{"$ref":"#/components/schemas/AudienceBreakdownBucket"}},"states":{"type":"array","items":{"$ref":"#/components/schemas/AudienceBreakdownBucket"}},"exportGrades":{"type":"array","items":{"$ref":"#/components/schemas/AudienceBreakdownBucket"}},"contactTiers":{"type":"array","items":{"$ref":"#/components/schemas/AudienceBreakdownBucket"}}},"required":["industries","seniorities","departments","companySizes","states","exportGrades","contactTiers"]},"IntentMatchedTopic":{"type":"object","properties":{"topicId":{"type":"integer"},"topicName":{"type":"string"},"type":{"type":["string","null"]},"industry":{"type":["string","null"]},"category":{"type":["string","null"]}},"required":["topicId","topicName"]},"IntentAudienceSiteActivity":{"type":"object","properties":{"alreadyOnSite":{"type":"boolean"},"sessions":{"type":"integer"},"pageviews":{"type":"integer"},"firstSeenAt":{"type":["string","null"],"format":"date-time"},"lastSeenAt":{"type":["string","null"],"format":"date-time"},"pixelIds":{"type":"array","items":{"type":"string"}},"domains":{"type":"array","items":{"type":"string"}},"lastLandingPage":{"type":["string","null"]},"lastReferrerDomain":{"type":["string","null"]},"lastUtmSource":{"type":["string","null"]},"lastUtmMedium":{"type":["string","null"]},"lastUtmCampaign":{"type":["string","null"]}},"required":["alreadyOnSite","sessions","pageviews","pixelIds","domains"]},"AudienceProfile":{"type":"object","properties":{"hashedEmail":{"type":["string","null"]},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"fullName":{"type":["string","null"]},"businessEmail":{"type":["string","null"]},"personalEmail":{"type":["string","null"]},"email":{"type":["string","null"]},"primaryContactEmail":{"type":["string","null"]},"phone":{"type":["string","null"]},"mobilePhone":{"type":["string","null"]},"directPhone":{"type":["string","null"]},"personalPhone":{"type":["string","null"]},"linkedinUrl":{"type":["string","null"]},"headline":{"type":["string","null"]},"jobTitle":{"type":["string","null"]},"roleBucket":{"type":["string","null"]},"seniority":{"type":["string","null"]},"department":{"type":["string","null"]},"profile":{"type":"object","properties":{"profilePidAll":{"type":["string","null"]},"duplicateProfileCount":{"type":["integer","null"]},"sourcePriority":{"type":["integer","null"]},"hemRecordRank":{"type":["integer","null"]},"isBestProfileForHem":{"type":"boolean"}}},"company":{"type":"object","properties":{"name":{"type":["string","null"]},"domain":{"type":["string","null"]},"linkedinUrl":{"type":["string","null"]},"domainTld":{"type":["string","null"]},"industry":{"type":["string","null"]},"industryGroup":{"type":["string","null"]},"naics":{"type":["string","null"]},"sic":{"type":["string","null"]},"description":{"type":["string","null"]},"revenueRange":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"country":{"type":["string","null"]},"zip":{"type":["string","null"]}}},"geo":{"type":"object","properties":{"city":{"type":["string","null"]},"state":{"type":["string","null"]},"stateCode":{"type":["string","null"]},"country":{"type":["string","null"]},"countryCode":{"type":["string","null"]},"zip":{"type":["string","null"]},"region":{"type":["string","null"]}}},"contact":{"type":"object","properties":{"hasBusinessEmail":{"type":"boolean"},"hasPersonalEmail":{"type":"boolean"},"hasAnyPhone":{"type":"boolean"},"businessEmailStatus":{"type":["string","null"]},"personalEmailStatus":{"type":["string","null"]},"phoneStatus":{"type":["string","null"]}}},"demographics":{"type":"object","properties":{"gender":{"type":["string","null"]},"ageRange":{"type":["string","null"]},"incomeRange":{"type":["string","null"]},"netWorth":{"type":["string","null"]}}},"role":{"type":"object","properties":{"signals":{"type":"object","additionalProperties":{"type":"boolean"}}}},"profileSignals":{"type":"object","additionalProperties":{"type":"boolean"}},"companySignals":{"type":"object","additionalProperties":{"type":"boolean"}},"geoSignals":{"type":"object","additionalProperties":{"type":"boolean"}},"compliance":{"type":"object","additionalProperties":true},"source":{"type":"object","additionalProperties":true},"siteActivity":{"$ref":"#/components/schemas/IntentAudienceSiteActivity"},"intent":{"type":"object","properties":{"score":{"type":"integer"},"topicOverlap":{"type":"integer"},"matchedTopics":{"type":"array","items":{"$ref":"#/components/schemas/IntentMatchedTopic"}}}}}},"AudiencePreview":{"type":"object","properties":{"configHash":{"type":"string"},"dataDate":{"type":"string","format":"date"},"strategy":{"type":"string","enum":["serving_table_in","sidecar_tuple_in"]},"totalCount":{"type":"integer"},"breakdowns":{"$ref":"#/components/schemas/AudiencePreviewBreakdowns"},"sample":{"type":"array","items":{"$ref":"#/components/schemas/AudienceProfile"}},"appliedFilters":{"type":"array","items":{"type":"string"}},"normalizedConfig":{"$ref":"#/components/schemas/IntentAudienceConfig"}},"required":["configHash","dataDate","strategy","totalCount","breakdowns","sample","appliedFilters","normalizedConfig"]},"IntentAudienceValidation":{"type":"object","properties":{"valid":{"type":"boolean","const":true},"configHash":{"type":"string"},"normalizedConfig":{"$ref":"#/components/schemas/IntentAudienceConfig"},"appliedFilters":{"type":"array","items":{"type":"string"}},"strategy":{"type":"string","enum":["serving_table_in","sidecar_tuple_in"]}},"required":["valid","configHash","normalizedConfig","appliedFilters","strategy"]},"IntentAudienceResults":{"type":"object","properties":{"run":{"$ref":"#/components/schemas/IntentAudienceRun"},"results":{"type":"array","items":{"$ref":"#/components/schemas/AudienceProfile"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["run","results","total","limit","offset"]},"IntentAudiencePendingResults":{"type":"object","properties":{"run":{"$ref":"#/components/schemas/IntentAudienceRun"},"state":{"type":"string","enum":["queued","running"]},"results":{"type":"array","items":{"$ref":"#/components/schemas/AudienceProfile"},"maxItems":0},"total":{"type":"integer","const":0},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["run","state","results","total","limit","offset"]},"IntentAudienceRunStats":{"type":"object","properties":{"total":{"type":"integer"},"fillRates":{"type":"object","additionalProperties":{"type":"object","properties":{"count":{"type":"integer"},"percent":{"type":"number"}},"required":["count","percent"]}},"scoreHistogram":{"type":"array","items":{"type":"object","properties":{"bucket":{"type":"string","enum":["50-69","70-89","90-99"]},"count":{"type":"integer"},"percent":{"type":"number"}},"required":["bucket","count","percent"]}},"averages":{"type":"object","properties":{}}},"required":["total","fillRates","scoreHistogram","averages"]},"IntentAudienceRunStatsResponse":{"type":"object","properties":{"run":{"$ref":"#/components/schemas/IntentAudienceRun"},"stats":{"$ref":"#/components/schemas/IntentAudienceRunStats"}},"required":["run","stats"]},"IntentAudienceDashboardSnapshot":{"type":"object","properties":{"total":{"type":"integer"},"companyCount":{"type":"integer"},"alreadyOnSiteCount":{"type":"integer"},"alreadyOnSitePercent":{"type":"number"},"highIntentCount":{"type":"integer"},"mediumIntentCount":{"type":"integer"},"lowIntentCount":{"type":"integer"},"averageIntentScore":{"type":["number","null"]},"maxIntentScore":{"type":["number","null"]},"averageTopicOverlap":{"type":["number","null"]},"maxTopicOverlap":{"type":["number","null"]},"businessEmailCount":{"type":"integer"},"businessEmailPercent":{"type":"number"},"anyEmailCount":{"type":"integer"},"anyEmailPercent":{"type":"number"},"anyPhoneCount":{"type":"integer"},"anyPhonePercent":{"type":"number"},"decisionMakerCount":{"type":"integer"},"decisionMakerPercent":{"type":"number"},"executiveCount":{"type":"integer"},"executivePercent":{"type":"number"}}},"IntentAudienceDashboardMovement":{"type":"object","properties":{"hasPreviousRun":{"type":"boolean"},"latestProfileCount":{"type":"integer"},"previousProfileCount":{"type":"integer"},"newProfileCount":{"type":"integer"},"droppedProfileCount":{"type":"integer"},"retainedProfileCount":{"type":"integer"},"scoreIncreasedCount":{"type":"integer"},"scoreDecreasedCount":{"type":"integer"},"scoreUnchangedCount":{"type":"integer"},"highIntentEntrantCount":{"type":"integer"},"highIntentExitCount":{"type":"integer"},"topicOverlapIncreasedCount":{"type":"integer"},"topicOverlapDecreasedCount":{"type":"integer"},"topicOverlapUnchangedCount":{"type":"integer"}}},"IntentAudienceDashboardSummary":{"type":"object","properties":{"hasPreviousRun":{"type":"boolean"},"totalPeople":{"type":"integer"},"previousPeople":{"type":"integer"},"newPeopleAdded":{"type":"integer"},"removedPeople":{"type":"integer"},"retainedPeople":{"type":"integer"},"intentIncreasedPeople":{"type":"integer"},"intentDecreasedPeople":{"type":"integer"},"intentUnchangedPeople":{"type":"integer"},"highIntentEnteredPeople":{"type":"integer"},"highIntentExitedPeople":{"type":"integer"},"topicOverlapIncreasedPeople":{"type":"integer"},"topicOverlapDecreasedPeople":{"type":"integer"},"topicOverlapUnchangedPeople":{"type":"integer"},"websiteVisits":{"type":"object","properties":{"people":{"type":"integer"},"sessions":{"type":"integer"},"pageviews":{"type":"integer"}}}}},"IntentAudienceTrendMovement":{"type":"object","properties":{"hasPreviousRun":{"type":"boolean"},"previousRunId":{"type":["string","null"],"format":"uuid"},"newProfileCount":{"type":"integer"},"droppedProfileCount":{"type":"integer"},"retainedProfileCount":{"type":"integer"},"scoreIncreasedCount":{"type":"integer"},"scoreDecreasedCount":{"type":"integer"},"scoreUnchangedCount":{"type":"integer"},"highIntentEntrantCount":{"type":"integer"},"highIntentExitCount":{"type":"integer"},"topicOverlapIncreasedCount":{"type":"integer"},"topicOverlapDecreasedCount":{"type":"integer"},"topicOverlapUnchangedCount":{"type":"integer"}}},"IntentAudienceTrendPoint":{"type":"object","properties":{"runId":{"type":"string","format":"uuid"},"resultKey":{"type":"string"},"runType":{"type":"string","enum":["manual","daily","preview"]},"dataDate":{"type":"string","format":"date"},"completedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"resultCount":{"type":"integer"},"total":{"type":"integer"},"companyCount":{"type":"integer"},"highIntentCount":{"type":"integer"},"mediumIntentCount":{"type":"integer"},"lowIntentCount":{"type":"integer"},"averageIntentScore":{"type":["number","null"]},"maxIntentScore":{"type":["number","null"]},"averageTopicOverlap":{"type":["number","null"]},"maxTopicOverlap":{"type":["number","null"]},"businessEmailCount":{"type":"integer"},"businessEmailPercent":{"type":"number"},"anyEmailCount":{"type":"integer"},"anyEmailPercent":{"type":"number"},"anyPhoneCount":{"type":"integer"},"anyPhonePercent":{"type":"number"},"decisionMakerCount":{"type":"integer"},"decisionMakerPercent":{"type":"number"},"executiveCount":{"type":"integer"},"executivePercent":{"type":"number"},"movement":{"$ref":"#/components/schemas/IntentAudienceTrendMovement"}}},"IntentAudienceTrends":{"type":"object","properties":{"audience":{"$ref":"#/components/schemas/IntentAudience"},"latestRun":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceRun"},{"type":"null"}]},"state":{"type":"string","enum":["ready","no_completed_runs"]},"points":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceTrendPoint"}}}},"IntentAudienceDashboardCompany":{"type":"object","properties":{"companyKey":{"type":"string"},"companyName":{"type":["string","null"]},"companyDomain":{"type":["string","null"]},"industry":{"type":["string","null"]},"industryGroup":{"type":["string","null"]},"profileCount":{"type":"integer"},"newProfileCount":{"type":"integer"},"highIntentCount":{"type":"integer"},"decisionMakerCount":{"type":"integer"},"businessEmailCount":{"type":"integer"},"averageIntentScore":{"type":["number","null"]},"maxIntentScore":{"type":["number","null"]}}},"IntentAudienceDashboardBucket":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer"},"highIntentCount":{"type":"integer"},"averageIntentScore":{"type":["number","null"]},"maxIntentScore":{"type":["number","null"]}}},"IntentAudienceDashboardPerson":{"type":"object","properties":{"hashedEmail":{"type":["string","null"]},"firstName":{"type":["string","null"]},"lastName":{"type":["string","null"]},"fullName":{"type":["string","null"]},"businessEmail":{"type":["string","null"]},"personalEmail":{"type":["string","null"]},"email":{"type":["string","null"]},"primaryContactEmail":{"type":["string","null"]},"mobilePhone":{"type":["string","null"]},"directPhone":{"type":["string","null"]},"personalPhone":{"type":["string","null"]},"phone":{"type":["string","null"]},"linkedinUrl":{"type":["string","null"]},"jobTitle":{"type":["string","null"]},"seniority":{"type":["string","null"]},"department":{"type":["string","null"]},"roleBucket":{"type":["string","null"]},"companyName":{"type":["string","null"]},"companyDomain":{"type":["string","null"]},"companyIndustry":{"type":["string","null"]},"companyIndustryGroup":{"type":["string","null"]},"siteActivity":{"$ref":"#/components/schemas/IntentAudienceSiteActivity"},"intentScore":{"type":"integer"},"previousIntentScore":{"type":["number","null"]},"scoreDelta":{"type":["number","null"]},"topicOverlap":{"type":"integer"},"previousTopicOverlap":{"type":["number","null"]},"topicOverlapDelta":{"type":["number","null"]}}},"IntentAudienceDashboard":{"type":"object","properties":{"audience":{"$ref":"#/components/schemas/IntentAudience"},"latestRun":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceRun"},{"type":"null"}]},"previousRun":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceRun"},{"type":"null"}]},"state":{"type":"string","enum":["ready","no_completed_runs"]},"summary":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceDashboardSummary"},{"type":"null"}]}}},"IntentAudienceSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"status":{"type":"string","enum":["draft","active","paused"]}},"required":["id","name","status"]},"IntentAudienceWebsiteVisitorMatch":{"type":"object","properties":{"audienceId":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"resultKey":{"type":"string"},"dataDate":{"type":"string","format":"date"},"audience":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceSummary"},{"type":"null"}]},"run":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceRun"},{"type":"null"}]},"intent":{"type":"object","properties":{"score":{"type":"integer"},"topicOverlap":{"type":"integer"},"matchedTopics":{"type":"array","items":{"$ref":"#/components/schemas/IntentMatchedTopic"}}}}}},"IntentAudienceWebsiteVisitorProfile":{"allOf":[{"$ref":"#/components/schemas/AudienceProfile"},{"type":"object","properties":{"audienceId":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"resultKey":{"type":"string"},"dataDate":{"type":"string","format":"date"},"audience":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceSummary"},{"type":"null"}]},"run":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceRun"},{"type":"null"}]},"audienceMatches":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceWebsiteVisitorMatch"}}}}]},"IntentAudienceWebsiteVisitorOverlaps":{"type":"object","properties":{"state":{"type":"string","enum":["ready","no_completed_runs"]},"scope":{"type":"object","properties":{"audienceId":{"type":["string","null"],"format":"uuid"}}},"audience":{"anyOf":[{"$ref":"#/components/schemas/IntentAudience"},{"type":"null"}]},"audiences":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceSummary"}},"latestRun":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceRun"},{"type":"null"}]},"latestRuns":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceRun"}},"results":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceWebsiteVisitorProfile"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"lookbackDays":{"type":"integer"}}},"IntentAudienceWebsiteVisitorTopicHistoryPoint":{"type":"object","properties":{"audienceId":{"type":"string","format":"uuid"},"runId":{"type":"string","format":"uuid"},"resultKey":{"type":"string"},"dataDate":{"type":"string","format":"date"},"audience":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceSummary"},{"type":"null"}]},"run":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceRun"},{"type":"null"}]},"intent":{"type":"object","properties":{"score":{"type":"integer"},"topicOverlap":{"type":"integer"},"matchedTopics":{"type":"array","items":{"$ref":"#/components/schemas/IntentMatchedTopic"}}}}}},"IntentAudienceWebsiteVisitorTopicHistory":{"type":"object","properties":{"hashedEmail":{"type":"string"},"audience":{"anyOf":[{"$ref":"#/components/schemas/IntentAudienceSummary"},{"type":"null"}]},"points":{"type":"array","items":{"$ref":"#/components/schemas/IntentAudienceWebsiteVisitorTopicHistoryPoint"}},"limit":{"type":"integer"}}},"DeleteResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"deleted":{"type":"boolean"}},"required":["id","deleted"]},"IntentAudienceResponseConfig":{"type":"object","properties":{"topicIds":{"type":"array","items":{"type":"integer"},"minItems":1,"maxItems":250},"minScore":{"type":"integer","minimum":0,"maximum":99,"description":"Accepted below 50, normalized/clamped to 50 by the backend."},"maxScore":{"type":"integer","minimum":50,"maximum":99,"default":99},"minTopicOverlap":{"type":"integer","minimum":1,"maximum":250,"default":1},"filters":{"type":"object","additionalProperties":true},"sourceUrl":{"type":"string","format":"uri"},"topics":{"type":"array","items":{"$ref":"#/components/schemas/IntentMatchedTopic"},"description":"Hydrated topic metadata for display. Present on audience responses; write requests should continue sending topicIds."}},"required":["topicIds"]}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Dashboard access token. Send as Authorization: Bearer <token>."},"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Organization API key (sk_...). Send as X-API-Key: <key>."}}}}