{"openapi":"3.0.0","info":{"title":"Sift API","description":"REST API for Sift data with API key authentication","version":"1.0.0"},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{}},"paths":{"/v0/sources/{sourceId}/items":{"post":{"summary":"Import one item","tags":["Custom API"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":256},"channelExternalId":{"default":"default","type":"string","minLength":1,"maxLength":256},"threadExternalId":{"type":"string","minLength":1,"maxLength":256},"parentExternalId":{"type":"string","minLength":1,"maxLength":256},"title":{"type":"string","maxLength":2000},"text":{"type":"string","minLength":1,"maxLength":64000},"occurredAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"sourceUrl":{"type":"string","format":"uri"},"author":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":256},"name":{"type":"string","minLength":1,"maxLength":256},"username":{"type":"string","maxLength":256},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"avatarUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"customFields":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"metadata":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}}},"required":["externalId","name"],"additionalProperties":false},"customFields":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"metadata":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"tagIds":{"default":[],"maxItems":32,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"An 8-4-4-4-12 hex identifier. Accepts any uuid-shaped value, not only RFC 4122-compliant ones: some existing rows predate an RFC-compliant id generator, and Postgres's uuid column accepts them, so the schema must too."}}},"required":["externalId","text","occurredAt","author"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":30},"in":"path","name":"sourceId","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v0/sources/{sourceId}/items/batch":{"post":{"summary":"Import up to 100 items","tags":["Custom API"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":256},"channelExternalId":{"default":"default","type":"string","minLength":1,"maxLength":256},"threadExternalId":{"type":"string","minLength":1,"maxLength":256},"parentExternalId":{"type":"string","minLength":1,"maxLength":256},"title":{"type":"string","maxLength":2000},"text":{"type":"string","minLength":1,"maxLength":64000},"occurredAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"sourceUrl":{"type":"string","format":"uri"},"author":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":256},"name":{"type":"string","minLength":1,"maxLength":256},"username":{"type":"string","maxLength":256},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"avatarUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"customFields":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"metadata":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}}},"required":["externalId","name"],"additionalProperties":false},"customFields":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"metadata":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"tagIds":{"default":[],"maxItems":32,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"An 8-4-4-4-12 hex identifier. Accepts any uuid-shaped value, not only RFC 4122-compliant ones: some existing rows predate an RFC-compliant id generator, and Postgres's uuid column accepts them, so the schema must too."}}},"required":["externalId","text","occurredAt","author"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":30},"in":"path","name":"sourceId","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v0/sources/{sourceId}/items/validate":{"post":{"summary":"Validate without storing","tags":["Custom API"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":256},"channelExternalId":{"default":"default","type":"string","minLength":1,"maxLength":256},"threadExternalId":{"type":"string","minLength":1,"maxLength":256},"parentExternalId":{"type":"string","minLength":1,"maxLength":256},"title":{"type":"string","maxLength":2000},"text":{"type":"string","minLength":1,"maxLength":64000},"occurredAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"sourceUrl":{"type":"string","format":"uri"},"author":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":256},"name":{"type":"string","minLength":1,"maxLength":256},"username":{"type":"string","maxLength":256},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"avatarUrl":{"type":"string","format":"uri"},"profileUrl":{"type":"string","format":"uri"},"customFields":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"metadata":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}}},"required":["externalId","name"],"additionalProperties":false},"customFields":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"metadata":{"default":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"tagIds":{"default":[],"maxItems":32,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"An 8-4-4-4-12 hex identifier. Accepts any uuid-shaped value, not only RFC 4122-compliant ones: some existing rows predate an RFC-compliant id generator, and Postgres's uuid column accepts them, so the schema must too."}}},"required":["externalId","text","occurredAt","author"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":30},"in":"path","name":"sourceId","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v0/sources/{sourceId}/receipts":{"get":{"summary":"Read recent receipts","tags":["Custom API"],"parameters":[{"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":30},"in":"path","name":"sourceId","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v0/sources/{sourceId}/receipts/{receiptId}":{"get":{"summary":"Read one receipt","tags":["Custom API"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":30},"in":"path","name":"sourceId","required":true},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"in":"path","name":"receiptId","required":true,"description":"An 8-4-4-4-12 hex identifier. Accepts any uuid-shaped value, not only RFC 4122-compliant ones: some existing rows predate an RFC-compliant id generator, and Postgres's uuid column accepts them, so the schema must too."}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v0/sources/{sourceId}/receipts/{receiptId}/retry":{"post":{"summary":"Retry failed work","tags":["Custom API"],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":30},"in":"path","name":"sourceId","required":true},{"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$"},"in":"path","name":"receiptId","required":true,"description":"An 8-4-4-4-12 hex identifier. Accepts any uuid-shaped value, not only RFC 4122-compliant ones: some existing rows predate an RFC-compliant id generator, and Postgres's uuid column accepts them, so the schema must too."}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v0/sources/{sourceId}/items/{externalId}":{"patch":{"summary":"Correct imported content","tags":["Custom API"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedRevision":{"type":"integer","minimum":1,"maximum":9007199254740991},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"text":{"type":"string","minLength":1,"maxLength":64000},"title":{"type":"string","maxLength":2000},"customFields":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"metadata":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema1"}}},"required":["expectedRevision","requestId"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":30},"in":"path","name":"sourceId","required":true},{"schema":{"type":"string","minLength":1,"maxLength":256},"in":"path","name":"externalId","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response"}}}},"/v0/action/list":{"get":{"summary":"Get actions list","tags":["v0"],"description":"Retrieve a list of actions with optional filtering.\n\n**Default Behavior:**\n- Returns actions from the past 7 days\n- Only includes actions with at least one agent response (ro=true)\n- Results are sorted by `createdAt` descending (newest first)\n\n**Sorting & Date Filtering:**\nThe `sortBy` parameter controls which date field is used for both the `from`/`to` date range filter and the sort order:\n- `sortBy=createdAt` (default) - Filter and sort by action creation time\n- `sortBy=updatedAt` - Filter and sort by last update time\n\nThe `from` and `to` parameters accept ISO 8601 date strings. You can pass a date (`2024-01-01`) or a full datetime (`2024-01-01T14:30:00Z`). Date-only values are interpreted as midnight UTC. Note that `to` is inclusive (`<=`), so `to=2024-01-31` means up to midnight at the start of Jan 31 — use `to=2024-02-01` or `to=2024-01-31T23:59:59Z` to include the full day.\n\nTo page through results, adjust the `from`/`to` window based on the relevant timestamp from the last record returned.\n\n**Filter DSL Syntax:**\nThe `filter` parameter accepts a simple DSL for filtering:\n- `ro=true` - Only responded actions (default)\n- `ro=false` - Include all actions\n- `src=TWITTER` - Filter by source platform\n- `st=OPEN` - Filter by status\n- `q=<uuid>` - Filter by queue ID\n- Multiple filters: `ro=true+src=TWITTER` (AND logic)\n\n**Full filter (`fullFilter`):**\nThe `filter` and `filterJson` parameters are frozen: they read only the responded flag. To apply every condition, send `fullFilter` with the Operations DSL (the same text as the Search page filter bar). It adds no responded default. Do not send it with `filter` or `filterJson`. A text that does not parse returns 400.\n\n**Examples:**\n```\n?fullFilter=src=TWITTER+kw~refund       # Full filter (Operations DSL)\n?filter=ro=true                    # Responded actions only (default)\n?filter=ro=false                   # All actions including unresponded\n?filter=ro=true+src=TWITTER        # Responded Twitter actions\n?from=2024-01-01&to=2024-01-31     # Custom date range\n?sortBy=updatedAt&from=2024-01-01  # Recently updated actions\n```","parameters":[{"schema":{},"in":"query","name":"from","required":false,"description":"Start date (ISO 8601). Accepts date (2024-01-01) or datetime (2024-01-01T14:30:00Z). Date-only values are midnight UTC."},{"schema":{},"in":"query","name":"to","required":false,"description":"End date (ISO 8601, inclusive <=). Use next day or T23:59:59Z to include the full end date."},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":500},"in":"query","name":"pageSize","required":false},{"schema":{"type":"string"},"in":"query","name":"filter","required":false},{"schema":{"type":"string"},"in":"query","name":"filterJson","required":false},{"schema":{"type":"string","maxLength":10000},"in":"query","name":"fullFilter","required":false,"description":"Full filter in the Operations DSL (the text of the Search page filter bar), for example `src=TWITTER+kw~refund`. Every leaf applies. No responded default is added. Do not send it with `filter` or `filterJson`."},{"schema":{"default":false,"type":"boolean"},"in":"query","name":"includeFullConversation","required":false},{"schema":{"default":"createdAt","type":"string","enum":["createdAt","updatedAt"]},"in":"query","name":"sortBy","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"actionId":{"type":"string"},"actionTitle":{"type":"string"},"actionSummary":{"type":"string"},"status":{"type":"string"},"platform":{"type":"string"},"recordType":{"nullable":true,"type":"string"},"isPublicPost":{"type":"boolean"},"siftURL":{"type":"string"},"sourceURL":{"nullable":true,"type":"string"},"queue":{"nullable":true,"type":"string"},"initialQueue":{"nullable":true,"type":"string"},"sentiment":{"nullable":true,"type":"string"},"sentimentScore":{"nullable":true,"type":"number"},"moderation":{"nullable":true,"type":"string"},"assigneeName":{"nullable":true,"type":"string"},"assigneeEmail":{"nullable":true,"type":"string"},"assigneeUserId":{"nullable":true,"type":"string"},"assigneeRole":{"nullable":true,"type":"string"},"userName":{"type":"string"},"userUsername":{"type":"string"},"userId":{"type":"string"},"userEmail":{"nullable":true,"type":"string"},"userFollowerCount":{"nullable":true,"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"nullable":true,"type":"string"},"initialMessageTime":{"nullable":true,"type":"string"},"initialResponseTime":{"nullable":true,"type":"string"},"closeTime":{"nullable":true,"type":"string"},"claimTime":{"nullable":true,"type":"string"},"firstResponseTime":{"nullable":true,"type":"string"},"handleTime":{"nullable":true,"type":"string"},"serverName":{"type":"string"},"channelName":{"type":"string"},"csatScore":{"nullable":true,"type":"string"},"csatFeedback":{"nullable":true,"type":"string"},"estimatedCSAT":{"nullable":true,"type":"number"},"totalMessages":{"nullable":true,"type":"number"},"totalUserMessages":{"nullable":true,"type":"number"},"totalAgentMessages":{"nullable":true,"type":"number"},"tags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"group":{"type":"string"}},"required":["value","group"],"additionalProperties":false}},"closingTags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"group":{"type":"string"}},"required":["value","group"],"additionalProperties":false}},"customFields":{"type":"object","additionalProperties":{}},"rootMessageText":{"nullable":true,"type":"string"},"conversationJson":{"nullable":true,"type":"string"}},"required":["actionId","actionTitle","actionSummary","status","platform","recordType","isPublicPost","siftURL","sourceURL","queue","initialQueue","sentiment","sentimentScore","moderation","assigneeName","assigneeEmail","assigneeUserId","assigneeRole","userName","userUsername","userId","userEmail","userFollowerCount","createdAt","updatedAt","initialMessageTime","initialResponseTime","closeTime","claimTime","firstResponseTime","handleTime","serverName","channelName","csatScore","csatFeedback","estimatedCSAT","totalMessages","totalUserMessages","totalAgentMessages","tags","closingTags","customFields","rootMessageText","conversationJson"],"additionalProperties":false}},"totalRecords":{"type":"number"},"currentPage":{"type":"number"},"pageSize":{"type":"number"},"totalPages":{"type":"number"}},"required":["data","totalRecords","currentPage","pageSize","totalPages"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/action/{id}":{"get":{"summary":"Get action by ID","tags":["v0"],"description":"Retrieve detailed information about a specific action","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"user":{"type":"object","properties":{"name":{"type":"string"},"username":{"type":"string"},"userId":{"type":"string"},"email":{"nullable":true,"type":"string"},"followerCount":{"nullable":true,"type":"number"}},"required":["name","username","userId","email","followerCount"],"additionalProperties":false},"actionId":{"type":"string"},"actionTitle":{"type":"string"},"actionSummary":{"type":"string"},"platform":{"type":"string"},"recordType":{"nullable":true,"type":"string"},"isPublicPost":{"type":"boolean"},"sentiment":{"nullable":true,"type":"string"},"sentimentScore":{"nullable":true,"type":"number"},"queue":{"nullable":true,"type":"string"},"initialQueue":{"nullable":true,"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string"},"siftURL":{"type":"string"},"sourceURL":{"nullable":true,"type":"string"},"updatedAt":{"nullable":true,"type":"string"},"initialMessageTime":{"nullable":true,"type":"string"},"initialResponseTime":{"nullable":true,"type":"string"},"closeTime":{"nullable":true,"type":"string"},"firstResponseTime":{"nullable":true,"type":"string"},"handleTime":{"nullable":true,"type":"string"},"claimTime":{"nullable":true,"type":"string"},"assignee":{"type":"object","properties":{"name":{"nullable":true,"type":"string"},"email":{"nullable":true,"type":"string"},"userId":{"nullable":true,"type":"string"},"role":{"nullable":true,"type":"string"}},"required":["name","email","userId","role"],"additionalProperties":false},"serverName":{"type":"string"},"channelName":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"group":{"type":"string"}},"required":["value","group"],"additionalProperties":false}},"closingTags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"group":{"type":"string"}},"required":["value","group"],"additionalProperties":false}},"moderation":{"nullable":true,"type":"string"},"comments":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"authorNativeId":{"type":"string"},"authorNativeName":{"nullable":true,"type":"string"}},"required":["text","authorNativeId","authorNativeName"],"additionalProperties":false}},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"timestamp":{"type":"string"},"author":{"type":"string"},"authorId":{"type":"string"},"authorType":{"type":"string","enum":["USER","AGENT","BOT"]},"message":{"type":"string"},"mediaUrls":{"type":"array","items":{"type":"string"}}},"required":["id","timestamp","author","authorType","message","mediaUrls"],"additionalProperties":false}},"rootMessageText":{"nullable":true,"type":"string"},"conversation":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"timestamp":{"type":"string"},"author":{"type":"string"},"authorId":{"nullable":true,"type":"string"},"authorType":{"type":"string","enum":["USER","AGENT","BOT"]},"message":{"type":"string"},"parentMessageId":{"nullable":true,"type":"string"},"mediaUrls":{"type":"array","items":{"type":"string"}}},"required":["id","timestamp","author","authorId","authorType","message","parentMessageId","mediaUrls"],"additionalProperties":false}},"customFields":{"type":"object","additionalProperties":{}},"csatScore":{"nullable":true,"type":"string"},"csatFeedback":{"nullable":true,"type":"string"},"estimatedCSAT":{"nullable":true,"type":"number"},"totalMessages":{"nullable":true,"type":"number"},"totalUserMessages":{"nullable":true,"type":"number"},"totalAgentMessages":{"nullable":true,"type":"number"}},"required":["user","actionId","actionTitle","actionSummary","platform","recordType","isPublicPost","sentiment","sentimentScore","queue","initialQueue","status","createdAt","siftURL","sourceURL","updatedAt","initialMessageTime","initialResponseTime","closeTime","firstResponseTime","handleTime","claimTime","assignee","serverName","channelName","tags","closingTags","moderation","comments","messages","rootMessageText","customFields","csatScore","csatFeedback","estimatedCSAT","totalMessages","totalUserMessages","totalAgentMessages"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/actions/{actionId}/custom-fields":{"patch":{"summary":"Set custom fields on an action","tags":["v0"],"description":"Set one or more case-level (ActionableInsightsThread) custom fields on an action. Requires the `write` scope. Each `fieldName` is validated against the org's OrgCustomField definitions; unknown fields are rejected with per-field errors. Optional `confidence` (0–1) and `rationale` are recorded on the value's provenance sidecar.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fields":{"minItems":1,"type":"array","items":{"type":"object","properties":{"fieldName":{"type":"string","minLength":1},"value":{},"confidence":{"type":"number","minimum":0,"maximum":1},"rationale":{"type":"string"}},"required":["fieldName"]}}},"required":["fields"]}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"actionId","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"actionId":{"type":"string"},"updated":{"type":"array","items":{"type":"object","properties":{"fieldName":{"type":"string"},"value":{}},"required":["fieldName","value"],"additionalProperties":false}}},"required":["actionId","updated"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}}}},"get":{"summary":"Get an action's custom fields","tags":["v0"],"description":"Return the current case-level custom field values on an action, with their display metadata and provenance. Requires the `read` scope.","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"actionId","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"actionId":{"type":"string"},"fields":{"type":"array","items":{"type":"object","properties":{"fieldName":{"type":"string"},"displayName":{"type":"string"},"fieldType":{"type":"string"},"value":{},"provenance":{}},"required":["fieldName","displayName","fieldType","value"],"additionalProperties":false}}},"required":["actionId","fields"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"fieldErrors":{"type":"object","additionalProperties":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/agents":{"get":{"summary":"Get agents list with metrics","tags":["v0"],"description":"Retrieve a list of all agents with their performance metrics and workload.\n\n**Metrics include:**\n- Total actions handled\n- Response time (median)\n- Handle time (median)\n- CSAT scores (actual and estimated)\n- Resolution quality, sentiment change\n- Current workload (active, closed, cancelled)\n\n**Query Parameters:**\n- `from` - Start date (ISO string, default: 30 days ago)\n- `to` - End date (ISO string, default: now)","parameters":[{"schema":{},"in":"query","name":"from","required":false},{"schema":{},"in":"query","name":"to","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"agentId":{"type":"string"},"metrics":{"type":"object","properties":{"totalActions":{"type":"number"},"totalActionsWithResponse":{"type":"number"},"totalMessages":{"type":"number"},"totalAgentMessages":{"type":"number"},"totalUserMessages":{"type":"number"},"averageCsat":{"type":"number"},"averageResponseTime":{"type":"number"},"averageHandleTime":{"type":"number"},"averageEstimatedCsat":{"type":"number"},"averageResolutionQuality":{"type":"number"},"averageSentimentChange":{"type":"number"},"averageRubricScore":{"type":"number"}},"required":["totalActions","totalActionsWithResponse","totalMessages","totalAgentMessages","totalUserMessages","averageCsat","averageResponseTime","averageHandleTime","averageEstimatedCsat","averageResolutionQuality","averageSentimentChange","averageRubricScore"],"additionalProperties":false},"workload":{"type":"object","properties":{"active":{"type":"number"},"closed":{"type":"number"},"cancelled":{"type":"number"}},"required":["active","closed","cancelled"],"additionalProperties":false}},"required":["agentId","metrics","workload"],"additionalProperties":false}}},"required":["success","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/agents/{id}":{"get":{"summary":"Get agent details","tags":["v0"],"description":"Retrieve detailed metrics and performance data for a specific agent.\n\n**Returns:**\n- Individual action/ticket metrics\n- Aggregated performance metrics\n- Current workload breakdown\n- Queue assignments","parameters":[{"schema":{},"in":"query","name":"from","required":false},{"schema":{},"in":"query","name":"to","required":false},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"metrics":{"type":"array","items":{"type":"object","additionalProperties":{}}},"aggregatedMetrics":{"type":"object","properties":{"totalActions":{"type":"number"},"totalMessages":{"type":"number"},"totalAgentMessages":{"type":"number"},"totalUserMessages":{"type":"number"},"averageCsat":{"type":"number"},"averageResponseTime":{"type":"number"},"averageHandleTime":{"type":"number"},"averageEstimatedCsat":{"type":"number"},"averageResolutionQuality":{"type":"number"},"averageSentimentChange":{"type":"number"},"averageRubricScore":{"type":"number"}},"required":["totalActions","totalMessages","totalAgentMessages","totalUserMessages","averageCsat","averageResponseTime","averageHandleTime","averageEstimatedCsat","averageResolutionQuality","averageSentimentChange","averageRubricScore"],"additionalProperties":false},"currentWorkload":{"type":"object","properties":{"active":{"type":"number"},"closed":{"type":"number"},"cancelled":{"type":"number"}},"required":["active","closed","cancelled"],"additionalProperties":false},"queues":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["metrics","aggregatedMetrics","currentWorkload","queues"],"additionalProperties":false}},"required":["success","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/queues":{"get":{"summary":"Get queues list with metrics","tags":["v0"],"description":"Retrieve a list of all queues with their performance metrics and workload.\n\n**Metrics include:**\n- Total actions handled\n- Response time (median)\n- Handle time (median)\n- CSAT scores (actual and estimated)\n- Resolution quality, sentiment metrics\n- Current workload (active, closed, cancelled)\n\n**Query Parameters:**\n- `from` - Start date (ISO string, default: 30 days ago)\n- `to` - End date (ISO string, default: now)","parameters":[{"schema":{},"in":"query","name":"from","required":false},{"schema":{},"in":"query","name":"to","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"queueId":{"nullable":true,"type":"string"},"queueName":{"nullable":true,"type":"string"},"metrics":{"type":"object","properties":{"totalActions":{"type":"number"},"totalMessages":{"type":"number"},"totalAgentMessages":{"type":"number"},"totalUserMessages":{"type":"number"},"averageCsat":{"type":"number"},"averageResponseTime":{"type":"number"},"averageHandleTime":{"type":"number"},"averageEstimatedCsat":{"type":"number"},"averageResolutionQuality":{"type":"number"},"averageSentimentChange":{"type":"number"},"averageRubricScore":{"type":"number"},"averageSentimentScore":{"type":"number"}},"required":["totalActions","totalMessages","totalAgentMessages","totalUserMessages","averageCsat","averageResponseTime","averageHandleTime","averageEstimatedCsat","averageResolutionQuality","averageSentimentChange","averageRubricScore","averageSentimentScore"],"additionalProperties":false},"workload":{"type":"object","properties":{"active":{"type":"number"},"closed":{"type":"number"},"cancelled":{"type":"number"}},"required":["active","closed","cancelled"],"additionalProperties":false}},"required":["queueId","queueName","metrics","workload"],"additionalProperties":false}}},"required":["success","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/analytics/tags":{"get":{"summary":"Get tag analytics dashboard","tags":["v0"],"description":"Retrieve comprehensive tag statistics including:\n- Summary metrics (total tags, tag groups, tagged records, actions)\n- Tag breakdown with distribution percentages\n- Volume by tag with response status and sentiment metrics\n\n**Query Parameters:**\n- `from` - Start date (ISO string, default: 7 days ago)\n- `to` - End date (ISO string, default: now)\n- `respondedOnly` - Only include responded actions (default: false)\n- `limit` - Number of tags to return (default: 10)\n- `offset` - Pagination offset (default: 0)\n- `search` - Filter tags by name","parameters":[{"schema":{},"in":"query","name":"from","required":false},{"schema":{},"in":"query","name":"to","required":false},{"schema":{"type":"boolean"},"in":"query","name":"respondedOnly","required":false},{"schema":{"type":"number"},"in":"query","name":"limit","required":false},{"schema":{"type":"number"},"in":"query","name":"offset","required":false},{"schema":{"type":"string"},"in":"query","name":"search","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"summary":{"type":"object","properties":{"totalTags":{"type":"number"},"totalTagGroups":{"type":"number"},"totalTaggedRecords":{"type":"number"},"totalActions":{"type":"number"}},"required":["totalTags","totalTagGroups","totalTaggedRecords","totalActions"],"additionalProperties":false},"tagBreakdown":{"type":"array","items":{"type":"object","properties":{"tagId":{"type":"string"},"tagName":{"type":"string"},"groupName":{"nullable":true,"type":"string"},"count":{"type":"number"},"percentage":{"type":"number"}},"required":["tagId","tagName","groupName","count","percentage"],"additionalProperties":false}},"volumeByTag":{"type":"array","items":{"type":"object","properties":{"tagId":{"type":"string"},"tagName":{"type":"string"},"total":{"type":"number"},"responded":{"type":"number"},"notResponded":{"type":"number"},"avgSentiment":{"nullable":true,"type":"number"},"avgActionability":{"nullable":true,"type":"number"},"avgRelevance":{"nullable":true,"type":"number"}},"required":["tagId","tagName","total","responded","notResponded","avgSentiment","avgActionability","avgRelevance"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"total":{"type":"number"},"limit":{"type":"number"},"offset":{"type":"number"},"hasMore":{"type":"boolean"}},"required":["total","limit","offset","hasMore"],"additionalProperties":false}},"required":["summary","tagBreakdown","volumeByTag","pagination"],"additionalProperties":false}},"required":["success","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/analytics/tags/volume":{"get":{"summary":"Get tag volume over time","tags":["v0"],"description":"Retrieve daily volume data for top tags, formatted for chart visualization.\n\n**Returns:**\n- `data` - Array of daily counts: `{ date: \"2024-01-01\", \"Billing\": 10, \"Support\": 5 }`\n- `tags` - List of tag names included in the data\n\n**Query Parameters:**\n- `from` - Start date (ISO string, default: 7 days ago)\n- `to` - End date (ISO string, default: now)\n- `respondedOnly` - Only include responded actions (default: false)\n- `topTagsLimit` - Number of top tags to include (default: 5)\n- `tagIds` - Comma-separated specific tag IDs to include","parameters":[{"schema":{},"in":"query","name":"from","required":false},{"schema":{},"in":"query","name":"to","required":false},{"schema":{"type":"boolean"},"in":"query","name":"respondedOnly","required":false},{"schema":{"type":"number"},"in":"query","name":"topTagsLimit","required":false},{"schema":{"type":"string"},"in":"query","name":"tagIds","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"}]}}},"tags":{"type":"array","items":{"type":"string"}}},"required":["data","tags"],"additionalProperties":false}},"required":["success","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/analytics/sentiment":{"get":{"summary":"Get daily sentiment distribution","tags":["v0"],"description":"Retrieve sentiment breakdown by day.\n\n**Returns array of:**\n- `day` - Date string\n- `Very Negative` - Count (sentiment <= 2)\n- `Negative` - Count (2 < sentiment <= 3)\n- `Neutral` - Count (3 < sentiment <= 6)\n- `Positive` - Count (sentiment > 6)\n\n**Query Parameters:**\n- `from` - Start date (ISO string, default: 7 days ago)\n- `to` - End date (ISO string, default: now)","parameters":[{"schema":{},"in":"query","name":"from","required":false},{"schema":{},"in":"query","name":"to","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"Very Negative":{"type":"number"},"Negative":{"type":"number"},"Neutral":{"type":"number"},"Positive":{"type":"number"}},"required":["day","Very Negative","Negative","Neutral","Positive"],"additionalProperties":false}}},"required":["success","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/analytics/sentiment/by-tag":{"get":{"summary":"Get sentiment breakdown by tag","tags":["v0"],"description":"Retrieve sentiment distribution for each tag.\n\n**Returns array of:**\n- `tagName` - Tag name\n- `veryNegative`, `negative`, `neutral`, `positive` - Counts\n- `totalMentions` - Total count\n\n**Query Parameters:**\n- `from` - Start date (ISO string, default: 7 days ago)\n- `to` - End date (ISO string, default: now)","parameters":[{"schema":{},"in":"query","name":"from","required":false},{"schema":{},"in":"query","name":"to","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"tagName":{"type":"string"},"veryNegative":{"type":"number"},"negative":{"type":"number"},"neutral":{"type":"number"},"positive":{"type":"number"},"totalMentions":{"type":"number"}},"required":["tagName","veryNegative","negative","neutral","positive","totalMentions"],"additionalProperties":false}}},"required":["success","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/analytics/engagement":{"get":{"summary":"Get user engagement metrics","tags":["v0"],"description":"Retrieve comprehensive user engagement analytics including:\n\n**Engagement Percentiles:**\n- Messages per user (p25, median, p75) by platform\n\n**Growth Trends:**\n- Week-over-week user growth by platform\n\n**Conversion Funnel:**\n- Active users → Analyzed users → Action users by platform\n\n**Query Parameters:**\n- `from` - Start date (ISO string, default: 7 days ago)\n- `to` - End date (ISO string, default: now)\n- `platforms` - Comma-separated platform filter (e.g., \"TWITTER,DISCORD\")","parameters":[{"schema":{},"in":"query","name":"from","required":false},{"schema":{},"in":"query","name":"to","required":false},{"schema":{"type":"string"},"in":"query","name":"platforms","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"engagementPercentiles":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string"},"p25MessagesPerUser":{"type":"number"},"medianMessagesPerUser":{"type":"number"},"p75MessagesPerUser":{"type":"number"}},"required":["platform","p25MessagesPerUser","medianMessagesPerUser","p75MessagesPerUser"],"additionalProperties":false}},"growthTrends":{"type":"array","items":{"type":"object","properties":{"week":{"type":"string","format":"date-time"},"platform":{"type":"string"},"currentWeekUsers":{"type":"number"},"previousWeekUsers":{"type":"number"},"growthPercentage":{"type":"number"}},"required":["week","platform","currentWeekUsers","previousWeekUsers","growthPercentage"],"additionalProperties":false}},"conversionFunnel":{"type":"array","items":{"type":"object","additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"}]}}}},"required":["engagementPercentiles","growthTrends","conversionFunnel"],"additionalProperties":false}},"required":["success","data"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/conversations/search":{"get":{"summary":"Search conversations","tags":["v0"],"description":"Search and filter conversations/threads using Advanced Search DSL.\n\n**Filter Syntax:**\n- `field=value` - equals\n- `field!=value` - not equals\n- `field>value` / `field<value` - comparisons\n- `field~value` - contains\n- `field=min..max` - range\n- `expr+expr` - AND\n- `expr|expr` - OR\n- `(expr)` - grouping\n\n**Fields:**\n- `kw` - keyword (full-text search)\n- `src` - source/platform (e.g., TWITTER, DISCORD)\n- `ch` - channel\n- `sent` - sentiment (1-10)\n- `tg` - tag\n- `ca` - createdAt (date, supports relative: -7d, -1m)\n- `st` - status (OPEN, RESPONDED, CLOSED)\n- `q` - queue\n\n**Examples:**\n```\n?filter=kw~refund                        # Search for \"refund\" in content\n?filter=sent<4                           # Negative sentiment (< 4)\n?filter=kw~refund+sent<4                 # \"refund\" AND negative sentiment\n?filter=ca>-7d+kw~cancel                 # Last 7 days AND keyword \"cancel\"\n?filter=(src=TWITTER|src=DISCORD)+st=OPEN # Twitter OR Discord, status OPEN\n?filter=sent=1..3                        # Sentiment range 1-3\n```","parameters":[{"schema":{"type":"string"},"in":"query","name":"filter","required":false},{"schema":{"default":1,"type":"integer","minimum":1,"maximum":10000},"in":"query","name":"page","required":false},{"schema":{"default":50,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"pageSize","required":false}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"object","properties":{"actionId":{"type":"string"},"actionTitle":{"type":"string"},"actionSummary":{"type":"string"},"status":{"type":"string"},"platform":{"type":"string"},"recordType":{"nullable":true,"type":"string"},"isPublicPost":{"type":"boolean"},"siftURL":{"type":"string"},"sourceURL":{"nullable":true,"type":"string"},"queue":{"nullable":true,"type":"string"},"initialQueue":{"nullable":true,"type":"string"},"sentiment":{"nullable":true,"type":"string"},"sentimentScore":{"nullable":true,"type":"number"},"moderation":{"nullable":true,"type":"string"},"assigneeName":{"nullable":true,"type":"string"},"assigneeEmail":{"nullable":true,"type":"string"},"assigneeUserId":{"nullable":true,"type":"string"},"assigneeRole":{"nullable":true,"type":"string"},"userName":{"type":"string"},"userUsername":{"type":"string"},"userId":{"type":"string"},"userEmail":{"nullable":true,"type":"string"},"userFollowerCount":{"nullable":true,"type":"number"},"createdAt":{"type":"string"},"updatedAt":{"nullable":true,"type":"string"},"initialMessageTime":{"nullable":true,"type":"string"},"initialResponseTime":{"nullable":true,"type":"string"},"closeTime":{"nullable":true,"type":"string"},"claimTime":{"nullable":true,"type":"string"},"firstResponseTime":{"nullable":true,"type":"string"},"handleTime":{"nullable":true,"type":"string"},"serverName":{"type":"string"},"channelName":{"type":"string"},"csatScore":{"nullable":true,"type":"string"},"csatFeedback":{"nullable":true,"type":"string"},"estimatedCSAT":{"nullable":true,"type":"number"},"totalMessages":{"nullable":true,"type":"number"},"totalUserMessages":{"nullable":true,"type":"number"},"totalAgentMessages":{"nullable":true,"type":"number"},"tags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"group":{"type":"string"}},"required":["value","group"],"additionalProperties":false}},"closingTags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"group":{"type":"string"}},"required":["value","group"],"additionalProperties":false}},"customFields":{"type":"object","additionalProperties":{}},"rootMessageText":{"nullable":true,"type":"string"},"conversationJson":{"nullable":true,"type":"string"},"threadId":{"type":"string"},"easyId":{"nullable":true,"type":"string"},"contributors":{"nullable":true,"type":"string"}},"required":["actionId","actionTitle","actionSummary","status","platform","recordType","isPublicPost","siftURL","sourceURL","queue","initialQueue","sentiment","sentimentScore","moderation","assigneeName","assigneeEmail","assigneeUserId","assigneeRole","userName","userUsername","userId","userEmail","userFollowerCount","createdAt","updatedAt","initialMessageTime","initialResponseTime","closeTime","claimTime","firstResponseTime","handleTime","serverName","channelName","csatScore","csatFeedback","estimatedCSAT","totalMessages","totalUserMessages","totalAgentMessages","tags","closingTags","customFields","rootMessageText","conversationJson","threadId","easyId","contributors"],"additionalProperties":false}},"totalRecords":{"type":"number"},"totalRecordsCapped":{"type":"boolean"},"currentPage":{"type":"number"},"pageSize":{"type":"number"},"totalPages":{"type":"number"}},"required":["success","data","totalRecords","totalRecordsCapped","currentPage","pageSize","totalPages"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/moderation/cases":{"post":{"summary":"Submit one moderation case","tags":["v0"],"description":"Accepts canonical media[] input and processes it asynchronously. Reusing externalId is idempotent. Requires the write scope.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":256},"sourceSystem":{"type":"string","minLength":1,"maxLength":128},"sourcePlatform":{"type":"string","minLength":1,"maxLength":128},"sourceAdId":{"type":"string","minLength":1,"maxLength":256},"advertiserId":{"type":"string","minLength":1,"maxLength":256},"advertiserName":{"type":"string","minLength":1,"maxLength":500},"campaignId":{"type":"string","minLength":1,"maxLength":256},"market":{"type":"string","minLength":1,"maxLength":128},"placement":{"type":"string","minLength":1,"maxLength":128},"language":{"default":"en","type":"string","minLength":1,"maxLength":64},"providerMetadata":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"landingPageUrl":{"nullable":true,"type":"string","format":"uri"},"title":{"type":"string","minLength":1,"maxLength":500},"headline":{"type":"string","minLength":1,"maxLength":500},"brandName":{"type":"string","minLength":1,"maxLength":500},"callToAction":{"type":"string","enum":["APPLY_NOW","BOOK_NOW","GET_NOW","INSTALL_NOW","MORE","SHOP_NOW","SIGN_UP","VIEW","WATCH"]},"publicProfile":{"type":"object","properties":{"displayName":{"type":"string","minLength":1,"maxLength":500},"logoUrl":{"type":"string","format":"uri"},"verified":{"type":"boolean"}},"additionalProperties":false},"media":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video"]},"position":{"type":"integer","minimum":1,"maximum":20}},"required":["url","type","position"],"additionalProperties":false}},"attachment":{"type":"object","properties":{"type":{"type":"string","enum":["web_view","deep_link","app_install","lens","long_form_video"]},"destinationUrl":{"nullable":true,"type":"string","format":"uri"}},"required":["type","destinationUrl"],"additionalProperties":false},"targeting":{"type":"object","properties":{"ageMin":{"nullable":true,"type":"integer","minimum":0,"maximum":120},"ageMax":{"nullable":true,"type":"integer","minimum":0,"maximum":120},"geos":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"string","minLength":1,"maxLength":128}},"languages":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["ageMin","geos"],"additionalProperties":false},"copy":{"type":"object","properties":{"body":{"type":"string","maxLength":20000},"caption":{"type":"string","maxLength":20000},"linkDescription":{"type":"string","maxLength":20000},"sourceTitle":{"type":"string","maxLength":20000}},"additionalProperties":false},"discoverTile":{"type":"boolean"},"partnershipAd":{"type":"boolean"},"format":{"nullable":true,"type":"string","enum":["single_image_or_video","story","collection","commercial","sponsored_snap","ar_lens","ar_filter"]},"arLens":{"nullable":true,"type":"string","format":"uri"},"submittedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["externalId","sourceSystem","sourcePlatform","sourceAdId","advertiserName","market","placement","landingPageUrl","title","media","attachment","targeting","copy"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"caseId":{"type":"string"},"externalId":{"type":"string"},"status":{"type":"string","enum":["accepted","duplicate"]},"analysisStatus":{"type":"string","enum":["pending"]},"evaluationId":{"type":"string"},"idempotency":{"type":"object","properties":{"key":{"type":"string"},"replayed":{"type":"boolean"}},"required":["key","replayed"],"additionalProperties":false}},"required":["caseId","externalId","status","analysisStatus","evaluationId","idempotency"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/moderation/cases/batch":{"post":{"summary":"Submit up to 100 moderation cases","tags":["v0"],"description":"Validates each item independently and enqueues accepted items through the single-case path. Requires the write scope.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cases":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"externalId":{"type":"string","minLength":1,"maxLength":256},"sourceSystem":{"type":"string","minLength":1,"maxLength":128},"sourcePlatform":{"type":"string","minLength":1,"maxLength":128},"sourceAdId":{"type":"string","minLength":1,"maxLength":256},"advertiserId":{"type":"string","minLength":1,"maxLength":256},"advertiserName":{"type":"string","minLength":1,"maxLength":500},"campaignId":{"type":"string","minLength":1,"maxLength":256},"market":{"type":"string","minLength":1,"maxLength":128},"placement":{"type":"string","minLength":1,"maxLength":128},"language":{"default":"en","type":"string","minLength":1,"maxLength":64},"providerMetadata":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}},"landingPageUrl":{"nullable":true,"type":"string","format":"uri"},"title":{"type":"string","minLength":1,"maxLength":500},"headline":{"type":"string","minLength":1,"maxLength":500},"brandName":{"type":"string","minLength":1,"maxLength":500},"callToAction":{"type":"string","enum":["APPLY_NOW","BOOK_NOW","GET_NOW","INSTALL_NOW","MORE","SHOP_NOW","SIGN_UP","VIEW","WATCH"]},"publicProfile":{"type":"object","properties":{"displayName":{"type":"string","minLength":1,"maxLength":500},"logoUrl":{"type":"string","format":"uri"},"verified":{"type":"boolean"}},"additionalProperties":false},"media":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["image","video"]},"position":{"type":"integer","minimum":1,"maximum":20}},"required":["url","type","position"],"additionalProperties":false}},"attachment":{"type":"object","properties":{"type":{"type":"string","enum":["web_view","deep_link","app_install","lens","long_form_video"]},"destinationUrl":{"nullable":true,"type":"string","format":"uri"}},"required":["type","destinationUrl"],"additionalProperties":false},"targeting":{"type":"object","properties":{"ageMin":{"nullable":true,"type":"integer","minimum":0,"maximum":120},"ageMax":{"nullable":true,"type":"integer","minimum":0,"maximum":120},"geos":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"string","minLength":1,"maxLength":128}},"languages":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}}},"required":["ageMin","geos"],"additionalProperties":false},"copy":{"type":"object","properties":{"body":{"type":"string","maxLength":20000},"caption":{"type":"string","maxLength":20000},"linkDescription":{"type":"string","maxLength":20000},"sourceTitle":{"type":"string","maxLength":20000}},"additionalProperties":false},"discoverTile":{"type":"boolean"},"partnershipAd":{"type":"boolean"},"format":{"nullable":true,"type":"string","enum":["single_image_or_video","story","collection","commercial","sponsored_snap","ar_lens","ar_filter"]},"arLens":{"nullable":true,"type":"string","format":"uri"},"submittedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["externalId","sourceSystem","sourcePlatform","sourceAdId","advertiserName","market","placement","landingPageUrl","title","media","attachment","targeting","copy"],"additionalProperties":false}}},"required":["cases"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"externalId":{"type":"string"},"caseId":{"type":"string"},"status":{"type":"string","enum":["accepted","duplicate","rejected"]},"analysisStatus":{"type":"string","enum":["pending"]},"evaluationId":{"type":"string"},"idempotency":{"type":"object","properties":{"key":{"type":"string"},"replayed":{"type":"boolean"}},"required":["key","replayed"],"additionalProperties":false},"errors":{"type":"array","items":{"type":"string"}},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}}},"required":["externalId","caseId","status"],"additionalProperties":false}}},"required":["results"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/moderation/cases/{caseId}":{"get":{"summary":"Get the exact current moderation evaluation status","tags":["v0"],"description":"Returns the exact current evaluation for this case. Requires the read scope and an ad_policy organization.","parameters":[{"schema":{"type":"string","minLength":1},"in":"path","name":"caseId","required":true}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"caseId":{"type":"string"},"externalId":{"type":"string"},"analysisStatus":{"type":"string","enum":["policy_not_configured","pending","running","completed","failed"]},"evaluationId":{"type":"string"},"decision":{"type":"object","properties":{"disposition":{"type":"string","enum":["age_gate","approve","escalate","reject"]},"confidence":{"type":"string","enum":["low","medium","high"]},"title":{"default":null,"nullable":true,"type":"string","minLength":1},"reason":{"type":"string","minLength":1},"hits":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string","minLength":1},"ruleSlug":{"type":"string","minLength":1},"polarity":{"type":"string","enum":["AMBIGUOUS","NEGATIVE","POSITIVE"]},"confidence":{"type":"string","enum":["low","medium","high"]},"reasoning":{"nullable":true,"type":"string"},"evidence":{"type":"array","items":{"type":"object","properties":{"modality":{"type":"string","enum":["image","video","text","metadata"]},"claim":{"type":"string","minLength":1},"locator":{"type":"object","properties":{"asset":{"type":"string","enum":["public_profile_logo"]},"mediaIndex":{"type":"integer","minimum":0,"maximum":9007199254740991},"boundingBox":{},"startSeconds":{"type":"number","minimum":0},"endSeconds":{"type":"number","minimum":0},"textSpan":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"end":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["start","end"],"additionalProperties":false}},"additionalProperties":false}},"required":["modality","claim"],"additionalProperties":false}}},"required":["ruleId","ruleSlug","polarity","confidence","reasoning","evidence"],"additionalProperties":false}},"advertiserAssessment":{"type":"object","properties":{"polarity":{"type":"string","enum":["AMBIGUOUS","NEGATIVE","POSITIVE"]},"reasoning":{"type":"string","minLength":1,"maxLength":1000}},"required":["polarity","reasoning"],"additionalProperties":false},"landingAssessment":{"type":"object","properties":{"polarity":{"type":"string","enum":["AMBIGUOUS","NEGATIVE","POSITIVE"]},"reasoning":{"type":"string","minLength":1,"maxLength":1000}},"required":["polarity","reasoning"],"additionalProperties":false},"decisionSource":{"default":"model","type":"string","enum":["model","fail_closed"]},"failureCode":{"default":null,"nullable":true,"type":"string","minLength":1,"maxLength":128},"failureMessage":{"default":null,"nullable":true,"type":"string","minLength":1,"maxLength":2048}},"required":["disposition","confidence","title","reason","hits","advertiserAssessment","landingAssessment","decisionSource","failureCode","failureMessage"],"additionalProperties":false},"failureCode":{"type":"string"}},"required":["caseId","externalId","analysisStatus"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"},"message":{"type":"string"},"code":{"type":"string","enum":["MODERATION_INPUT_INCOMPLETE","MODERATION_INPUT_INVALID"]},"missingFields":{"type":"array","items":{"type":"string"}},"invalidFields":{"type":"array","items":{"type":"string"}},"supported":{"type":"array","items":{"type":"string"}}},"required":["success","error"],"additionalProperties":false}}}}}}},"/v0/ingest/records":{"post":{"summary":"Ingest normalized records","tags":["v0"],"description":"Accepts a batch of records already mapped to Sift's normalized shape and ingests them asynchronously (store, create actions, synthesize). Idempotent per (org, platform, serverId, externalId). Requires the write scope.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["DISCORD","SLACK","GITHUB","ZENDESK","REDDIT","TELEGRAM","FACEBOOK_GROUP","TWITTER_COMMUNITY","SALESFORCE","FACEBOOK","TWITTER","THREADS","TIKTOK","INSTAGRAM","LINKEDIN","WHATSAPP","YOUTUBE","GAINSIGHT","APPSTORE","GOOGLE_PLAY","HIGHER_LOGIC","DISCOURSE","CUSTOM_FORM","CUSTOM_API","MODERATION_API","CHROME_WEB_STORE","CANNY"]},"serverId":{"type":"string","minLength":1},"serverName":{"type":"string","minLength":1},"channelId":{"type":"string"},"channelName":{"type":"string"},"processingLevel":{"type":"string","enum":["INSIGHTS","STATS_ONLY"]},"source":{"type":"object","properties":{"system":{"type":"string","minLength":1},"sourceId":{"type":"string"}},"required":["system"]},"records":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"externalId":{"type":"string","minLength":1},"threadExternalId":{"type":"string"},"parentExternalId":{"type":"string"},"authorId":{"type":"string","minLength":1},"authorName":{"type":"string","minLength":1},"title":{"type":"string"},"body":{"type":"string"},"score":{"type":"number","minimum":0,"maximum":5},"createdAt":{"type":"string","minLength":1},"url":{"type":"string"},"recordType":{"type":"string","minLength":1},"customFields":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/schema0"}}},"required":["externalId","authorId","authorName","body","createdAt","recordType"]}}},"required":["platform","serverId","serverName","records"],"additionalProperties":false}}}},"security":[{"apiKey":[]}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["accepted"]},"accepted":{"type":"number"}},"required":["status","accepted"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[false]},"error":{"type":"string"}},"required":["success","error"],"additionalProperties":false}}}}}}}},"tags":[{"name":"v0","description":"Initial version endpoints"}]}