{"openapi":"3.1.0","info":{"version":"0.1.1","title":"Inkeep Analytics API","description":"The Inkeep Analytics API provides endpoints for managing conversations, feedback, events, and queries. For details on authentication, see [authentication documentation](/analytics-api/authentication)"},"security":[{"ApiIntegrationKey":[]}],"servers":[{"url":"https://api.analytics.inkeep.com"}],"tags":[{"name":"conversation","description":"Use to submit chats or threads for analysis. Can also work as a way to provide \"Share\" or \"Saved chats\" functionality."},{"name":"feedback","description":"Use to provide positive or negative feedback along with details."},{"name":"events","description":"Use to log conversation or message events, like \"conversation_shared\" or \"message_code_snippet_copied\"."}],"x-speakeasy-retries":{"strategy":"backoff","backoff":{"initialInterval":100,"maxInterval":2000,"maxElapsedTime":3600000,"exponent":1.5},"statusCodes":["5XX","429"],"retryConnectionErrors":true},"components":{"securitySchemes":{"ApiIntegrationKey":{"type":"http","scheme":"bearer","description":"The API key for an API integration. For more details, see [authentication documentation](/analytics-api/authentication)"},"WebIntegrationKey":{"type":"http","scheme":"bearer","description":"The API key for a Web integration. For more details, see [authentication documentation](/analytics-api/authentication)"},"JwtToken":{"type":"http","scheme":"bearer","description":"The JWT token for a user. For more details, see [authentication documentation](/analytics-api/authentication)"}},"schemas":{"OpenAIImageUrlObject":{"type":["object","null"],"properties":{"url":{"type":"string"},"detail":{"type":"string","enum":["auto","low","high"],"default":"auto"}},"required":["url"]},"OpenAIContentItem":{"type":"object","properties":{"type":{"type":"string","enum":["text","image_url"]},"text":{"type":["string","null"]},"image_url":{"$ref":"#/components/schemas/OpenAIImageUrlObject"}},"required":["type"]},"OpenAIToolCallFunction":{"type":"object","properties":{"name":{"type":"string"},"arguments":{"type":"string"}},"required":["name","arguments"]},"OpenAIToolCall":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["function"]},"function":{"$ref":"#/components/schemas/OpenAIToolCallFunction"}},"required":["id","type","function"]},"BaseMessage":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["openai","support_ticket","support_copilot"]},"externalId":{"type":["string","null"]},"externalUrl":{"type":["string","null"]},"conversationId":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"role":{"type":"string"},"content":{"type":["string","null"]},"name":{"type":["string","null"]},"links":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"type":{"anyOf":[{"type":"string","enum":["documentation","site","discourse_post","github_issue","github_discussion","stackoverflow_question","discord_forum_post","discord_message","custom_question_answer"]},{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":["array","null"],"items":{"type":"string"}}},"required":["url"]}},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true}},"required":["id","type","externalId","externalUrl","conversationId","createdAt","updatedAt","role","content"]},"OpenAIExtendedMessage":{"allOf":[{"$ref":"#/components/schemas/BaseMessage"},{"type":"object","properties":{"type":{"type":"string","enum":["openai"]},"role":{"type":"string","enum":["system","user","assistant"]},"content":{"anyOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/OpenAIContentItem"}}]},"tool_calls":{"type":["array","null"],"items":{"$ref":"#/components/schemas/OpenAIToolCall"}}}}],"description":"A message that includes the OpenAI chat completion details."},"OpenAIChatCompletionMessage":{"type":"object","properties":{"role":{"type":"string","enum":["system","user","assistant"]},"name":{"type":["string","null"]},"content":{"anyOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/OpenAIContentItem"}}]},"tool_calls":{"type":["array","null"],"items":{"$ref":"#/components/schemas/OpenAIToolCall"}}},"required":["role","content"]},"MessagesOpenAIFormat":{"type":"array","items":{"$ref":"#/components/schemas/OpenAIChatCompletionMessage"}},"SupportTicketMessage":{"allOf":[{"$ref":"#/components/schemas/BaseMessage"},{"type":"object","properties":{"type":{"type":"string","enum":["support_ticket"]}}}]},"SupportCopilotMessage":{"allOf":[{"$ref":"#/components/schemas/BaseMessage"},{"type":"object","properties":{"type":{"type":"string","enum":["support_copilot"]}}}]},"Message":{"oneOf":[{"$ref":"#/components/schemas/OpenAIExtendedMessage"},{"$ref":"#/components/schemas/SupportTicketMessage"},{"$ref":"#/components/schemas/SupportCopilotMessage"}],"discriminator":{"propertyName":"type","mapping":{"openai":"#/components/schemas/OpenAIExtendedMessage","support_ticket":"#/components/schemas/SupportTicketMessage","support_copilot":"#/components/schemas/SupportCopilotMessage"}}},"BaseConversation":{"type":"object","properties":{"id":{"type":"string"},"externalId":{"type":["string","null"]},"externalUrl":{"type":["string","null"]},"type":{"type":"string","enum":["openai","support_ticket","support_copilot"]},"supportTicketConversationId":{"type":["string","null"]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"tags":{"type":["array","null"],"items":{"type":"string"}},"visibility":{"type":["string","null"],"enum":["private","public"]},"messages":{"type":"array","items":{"$ref":"#/components/schemas/Message"},"minItems":1,"description":"The messages in the conversation. Must be at least one message."}},"required":["id","externalId","externalUrl","type","supportTicketConversationId","createdAt","updatedAt","projectId","integrationId","visibility","messages"]},"OpenAIConversation":{"allOf":[{"$ref":"#/components/schemas/BaseConversation"},{"type":"object","properties":{"type":{"type":"string","enum":["openai"]},"messages":{"type":"array","items":{"$ref":"#/components/schemas/OpenAIExtendedMessage"},"minItems":1,"description":"The messages in the conversation. Must be at least one message."},"messagesOpenAIFormat":{"$ref":"#/components/schemas/MessagesOpenAIFormat"}},"required":["messagesOpenAIFormat"]}]},"SupportTicketConversation":{"allOf":[{"$ref":"#/components/schemas/BaseConversation"},{"type":"object","properties":{"type":{"type":"string","enum":["support_ticket"]},"messages":{"type":"array","items":{"$ref":"#/components/schemas/SupportTicketMessage"},"minItems":1,"description":"The messages in the conversation. Must be at least one message."}}}]},"SupportCopilotConversation":{"allOf":[{"$ref":"#/components/schemas/BaseConversation"},{"type":"object","properties":{"type":{"type":"string","enum":["support_copilot"]},"messages":{"type":"array","items":{"$ref":"#/components/schemas/SupportCopilotMessage"},"minItems":1,"description":"The messages in the conversation. Must be at least one message."}}}]},"Conversation":{"oneOf":[{"$ref":"#/components/schemas/OpenAIConversation"},{"$ref":"#/components/schemas/SupportTicketConversation"},{"$ref":"#/components/schemas/SupportCopilotConversation"}],"discriminator":{"propertyName":"type","mapping":{"openai":"#/components/schemas/OpenAIConversation","support_ticket":"#/components/schemas/SupportTicketConversation","support_copilot":"#/components/schemas/SupportCopilotConversation"}},"title":"ConversationSelect"},"ProblemDetails":{"type":"object","properties":{"title":{"type":"string","description":"A short, human-readable summary of the problem type.","example":"Resource Not Found"},"status":{"type":"integer","description":"The HTTP status code.","example":404},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem.","example":"The requested resource was not found."},"instance":{"type":"string","description":"A URI reference that identifies the specific occurrence of the problem.","example":"/conversations/123"},"requestId":{"type":"string","description":"A unique identifier for the request, useful for troubleshooting.","example":"req_1234567890"},"code":{"type":"string","enum":["bad_request","unauthorized","forbidden","not_found","internal_server_error","unprocessable_entity"],"description":"A short code indicating the error code returned.","example":"not_found"}},"required":["title","status","detail","code"]},"BadRequest":{"allOf":[{"$ref":"#/components/schemas/ProblemDetails"},{"type":"object","properties":{"title":{"type":"string","description":"A short, human-readable summary of the problem type.","example":"Bad Request"},"status":{"type":"number","enum":[400],"description":"The HTTP status code.","example":400},"detail":{"type":"string","description":"A detailed explanation specific to this occurrence of the problem, providing context and specifics about what went wrong.","example":"Bad Request"},"code":{"type":"string","enum":["bad_request"],"description":"A short code indicating the error code returned.","example":"bad_request"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["bad_request"],"description":"A short code indicating the error code returned.","example":"bad_request"},"message":{"type":"string","description":"A concise error message suitable for display to end users. May be truncated if the full detail is long.","example":"Bad Request"}},"required":["code","message"],"description":"Legacy error format for backward compatibility."}},"required":["error"]}]},"Unauthorized":{"allOf":[{"$ref":"#/components/schemas/ProblemDetails"},{"type":"object","properties":{"title":{"type":"string","description":"A short, human-readable summary of the problem type.","example":"Unauthorized"},"status":{"type":"number","enum":[401],"description":"The HTTP status code.","example":401},"detail":{"type":"string","description":"A detailed explanation specific to this occurrence of the problem, providing context and specifics about what went wrong.","example":"Unauthorized"},"code":{"type":"string","enum":["unauthorized"],"description":"A short code indicating the error code returned.","example":"unauthorized"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized"],"description":"A short code indicating the error code returned.","example":"unauthorized"},"message":{"type":"string","description":"A concise error message suitable for display to end users. May be truncated if the full detail is long.","example":"Unauthorized"}},"required":["code","message"],"description":"Legacy error format for backward compatibility."}},"required":["error"]}]},"Forbidden":{"allOf":[{"$ref":"#/components/schemas/ProblemDetails"},{"type":"object","properties":{"title":{"type":"string","description":"A short, human-readable summary of the problem type.","example":"Forbidden"},"status":{"type":"number","enum":[403],"description":"The HTTP status code.","example":403},"detail":{"type":"string","description":"A detailed explanation specific to this occurrence of the problem, providing context and specifics about what went wrong.","example":"Forbidden"},"code":{"type":"string","enum":["forbidden"],"description":"A short code indicating the error code returned.","example":"forbidden"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["forbidden"],"description":"A short code indicating the error code returned.","example":"forbidden"},"message":{"type":"string","description":"A concise error message suitable for display to end users. May be truncated if the full detail is long.","example":"Forbidden"}},"required":["code","message"],"description":"Legacy error format for backward compatibility."}},"required":["error"]}]},"UnprocessableEntity":{"allOf":[{"$ref":"#/components/schemas/ProblemDetails"},{"type":"object","properties":{"title":{"type":"string","description":"A short, human-readable summary of the problem type.","example":"Unprocessable Entity"},"status":{"type":"number","enum":[422],"description":"The HTTP status code.","example":422},"detail":{"type":"string","description":"A detailed explanation specific to this occurrence of the problem, providing context and specifics about what went wrong.","example":"Unprocessable Entity"},"code":{"type":"string","enum":["unprocessable_entity"],"description":"A short code indicating the error code returned.","example":"unprocessable_entity"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["unprocessable_entity"],"description":"A short code indicating the error code returned.","example":"unprocessable_entity"},"message":{"type":"string","description":"A concise error message suitable for display to end users. May be truncated if the full detail is long.","example":"Unprocessable Entity"}},"required":["code","message"],"description":"Legacy error format for backward compatibility."}},"required":["error"]}]},"InternalServerError":{"allOf":[{"$ref":"#/components/schemas/ProblemDetails"},{"type":"object","properties":{"title":{"type":"string","description":"A short, human-readable summary of the problem type.","example":"Internal Server Error"},"status":{"type":"number","enum":[500],"description":"The HTTP status code.","example":500},"detail":{"type":"string","description":"A detailed explanation specific to this occurrence of the problem, providing context and specifics about what went wrong.","example":"Internal Server Error"},"code":{"type":"string","enum":["internal_server_error"],"description":"A short code indicating the error code returned.","example":"internal_server_error"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["internal_server_error"],"description":"A short code indicating the error code returned.","example":"internal_server_error"},"message":{"type":"string","description":"A concise error message suitable for display to end users. May be truncated if the full detail is long.","example":"Internal Server Error"}},"required":["code","message"],"description":"Legacy error format for backward compatibility."}},"required":["error"]}]},"CreateBaseMessage":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","enum":["openai","support_ticket","support_copilot"]},"externalId":{"type":["string","null"]},"externalUrl":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"role":{"type":"string"},"content":{"type":["string","null"]},"name":{"type":["string","null"]},"links":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"type":{"anyOf":[{"type":"string","enum":["documentation","site","discourse_post","github_issue","github_discussion","stackoverflow_question","discord_forum_post","discord_message","custom_question_answer"]},{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":["array","null"],"items":{"type":"string"}}},"required":["url"]}},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true}},"required":["type","role"],"title":"CreateBaseMessage"},"CreateOpenAIExtendedMessage":{"allOf":[{"$ref":"#/components/schemas/CreateBaseMessage"},{"type":"object","properties":{"type":{"type":"string","enum":["openai"]},"role":{"type":"string","enum":["system","user","assistant"]},"content":{"anyOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/OpenAIContentItem"}}]},"tool_calls":{"type":["array","null"],"items":{"$ref":"#/components/schemas/OpenAIToolCall"}}},"required":["content"]}],"title":"CreateBaseMessage"},"CreateSupportTicketMessage":{"allOf":[{"$ref":"#/components/schemas/CreateBaseMessage"},{"type":"object","properties":{"type":{"type":"string","enum":["support_ticket"]}}}],"title":"CreateBaseMessage"},"CreateSupportCopilotMessage":{"allOf":[{"$ref":"#/components/schemas/CreateBaseMessage"},{"type":"object","properties":{"type":{"type":"string","enum":["support_copilot"]}}}],"title":"CreateBaseMessage"},"CreateMessage":{"oneOf":[{"$ref":"#/components/schemas/CreateOpenAIExtendedMessage"},{"$ref":"#/components/schemas/CreateSupportTicketMessage"},{"$ref":"#/components/schemas/CreateSupportCopilotMessage"}],"discriminator":{"propertyName":"type","mapping":{"openai":"#/components/schemas/CreateOpenAIExtendedMessage","support_ticket":"#/components/schemas/CreateSupportTicketMessage","support_copilot":"#/components/schemas/CreateSupportCopilotMessage"}}},"CreateBaseConversation":{"type":"object","properties":{"id":{"type":"string"},"externalId":{"type":["string","null"]},"externalUrl":{"type":["string","null"]},"type":{"type":"string","enum":["openai","support_ticket","support_copilot"]},"supportTicketConversationId":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"tags":{"type":["array","null"],"items":{"type":"string"}},"visibility":{"type":["string","null"],"enum":["private","public"]},"messages":{"type":"array","items":{"$ref":"#/components/schemas/CreateMessage"},"minItems":1,"description":"The messages in the conversation. Must be at least one message."}},"required":["type","messages"]},"CreateOpenAIConversation":{"allOf":[{"$ref":"#/components/schemas/CreateBaseConversation"},{"type":"object","properties":{"type":{"type":"string","enum":["openai"]},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"externalId":{"type":["string","null"]},"externalUrl":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"role":{"type":"string","enum":["system","user","assistant"]},"content":{"anyOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/OpenAIContentItem"}}]},"name":{"type":["string","null"]},"links":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"type":{"anyOf":[{"type":"string","enum":["documentation","site","discourse_post","github_issue","github_discussion","stackoverflow_question","discord_forum_post","discord_message","custom_question_answer"]},{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":["array","null"],"items":{"type":"string"}}},"required":["url"]}},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"tool_calls":{"type":["array","null"],"items":{"$ref":"#/components/schemas/OpenAIToolCall"}}},"required":["role","content"]},"minItems":1,"description":"The messages in the conversation. Must be at least one message."}}}],"title":"CreateOpenAIConversation"},"CreateSupportTicketConversation":{"allOf":[{"$ref":"#/components/schemas/CreateBaseConversation"},{"type":"object","properties":{"type":{"type":"string","enum":["support_ticket"]},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"externalId":{"type":["string","null"]},"externalUrl":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"role":{"type":"string"},"content":{"type":["string","null"]},"name":{"type":["string","null"]},"links":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"type":{"anyOf":[{"type":"string","enum":["documentation","site","discourse_post","github_issue","github_discussion","stackoverflow_question","discord_forum_post","discord_message","custom_question_answer"]},{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":["array","null"],"items":{"type":"string"}}},"required":["url"]}},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true}},"required":["role"]},"minItems":1}}}],"title":"CreateSupportTicketConversation"},"CreateSupportCopilotConversation":{"allOf":[{"$ref":"#/components/schemas/CreateBaseConversation"},{"type":"object","properties":{"type":{"type":"string","enum":["support_copilot"]},"messages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"externalId":{"type":["string","null"]},"externalUrl":{"type":["string","null"]},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"role":{"type":"string"},"content":{"type":["string","null"]},"name":{"type":["string","null"]},"links":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":["string","null"]},"url":{"type":"string"},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"type":{"anyOf":[{"type":"string","enum":["documentation","site","discourse_post","github_issue","github_discussion","stackoverflow_question","discord_forum_post","discord_message","custom_question_answer"]},{"type":"string"},{"type":"null"}]},"breadcrumbs":{"type":["array","null"],"items":{"type":"string"}}},"required":["url"]}},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true}},"required":["role"]},"minItems":1}}}],"title":"CreateSupportCopilotConversation"},"CreateConversation":{"oneOf":[{"$ref":"#/components/schemas/CreateOpenAIConversation"},{"$ref":"#/components/schemas/CreateSupportTicketConversation"},{"$ref":"#/components/schemas/CreateSupportCopilotConversation"}],"discriminator":{"propertyName":"type","mapping":{"openai":"#/components/schemas/CreateOpenAIConversation","support_ticket":"#/components/schemas/CreateSupportTicketConversation","support_copilot":"#/components/schemas/CreateSupportCopilotConversation"}},"title":"CreateConversation"},"NotFound":{"allOf":[{"$ref":"#/components/schemas/ProblemDetails"},{"type":"object","properties":{"title":{"type":"string","description":"A short, human-readable summary of the problem type.","example":"Not Found"},"status":{"type":"number","enum":[404],"description":"The HTTP status code.","example":404},"detail":{"type":"string","description":"A detailed explanation specific to this occurrence of the problem, providing context and specifics about what went wrong.","example":"Not Found"},"code":{"type":"string","enum":["not_found"],"description":"A short code indicating the error code returned.","example":"not_found"},"error":{"type":"object","properties":{"code":{"type":"string","enum":["not_found"],"description":"A short code indicating the error code returned.","example":"not_found"},"message":{"type":"string","description":"A concise error message suitable for display to end users. May be truncated if the full detail is long.","example":"Not Found"}},"required":["code","message"],"description":"Legacy error format for backward compatibility."}},"required":["error"]}]},"GetAllFeedbackResponse":{"type":"object","properties":{"positiveFeedbackCount":{"type":"number"},"negativeFeedbackCount":{"type":"number"},"positiveFeedback":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["positive","negative"]},"messageId":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"reasons":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":"string"},"details":{"type":"string"}},"required":["label","details"]}},"details":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"sources":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":["string","null"],"enum":["positive","negative","new"]},"title":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["type"]}},"conversation":{"$ref":"#/components/schemas/Conversation"},"message":{"$ref":"#/components/schemas/Message"}},"required":["id","type","messageId","createdAt","updatedAt","conversation","message"]}},"negativeFeedback":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["positive","negative"]},"messageId":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"reasons":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":"string"},"details":{"type":"string"}},"required":["label","details"]}},"details":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"sources":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":["string","null"],"enum":["positive","negative","new"]},"title":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["type"]}},"conversation":{"$ref":"#/components/schemas/Conversation"},"message":{"$ref":"#/components/schemas/Message"}},"required":["id","type","messageId","createdAt","updatedAt","conversation","message"]}}},"required":["positiveFeedbackCount","negativeFeedbackCount","positiveFeedback","negativeFeedback"]},"SelectMessageEvent":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"messageId":{"type":"string"},"createdAt":{"type":"string"},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"entityType":{"type":"string","enum":["message"]}},"required":["id","type","messageId","createdAt","projectId","integrationId","entityType"]},"SelectConversationEvent":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"conversationId":{"type":"string"},"createdAt":{"type":"string"},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"entityType":{"type":"string","enum":["conversation"]}},"required":["id","type","conversationId","createdAt","projectId","integrationId","entityType"]},"SelectSearchEvent":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"searchQuery":{"type":"string"},"createdAt":{"type":"string"},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"entityType":{"type":"string","enum":["search"]}},"required":["id","type","searchQuery","createdAt","projectId","integrationId","entityType"]},"SelectEvent":{"oneOf":[{"$ref":"#/components/schemas/SelectMessageEvent"},{"$ref":"#/components/schemas/SelectConversationEvent"},{"$ref":"#/components/schemas/SelectSearchEvent"}],"discriminator":{"propertyName":"entityType","mapping":{"message":"#/components/schemas/SelectMessageEvent","conversation":"#/components/schemas/SelectConversationEvent","search":"#/components/schemas/SelectSearchEvent"}}},"InsertMessageEvent":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string"},"messageId":{"type":"string"},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"entityType":{"type":"string","enum":["message"]}},"required":["type","messageId","entityType"]},"InsertConversationEvent":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string"},"conversationId":{"type":"string"},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"entityType":{"type":"string","enum":["conversation"]}},"required":["type","conversationId","entityType"]},"InsertSearchEvent":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string"},"searchQuery":{"type":"string"},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"entityType":{"type":"string","enum":["search"]}},"required":["type","searchQuery","entityType"]},"InsertEvent":{"oneOf":[{"$ref":"#/components/schemas/InsertMessageEvent"},{"$ref":"#/components/schemas/InsertConversationEvent"},{"$ref":"#/components/schemas/InsertSearchEvent"}],"discriminator":{"propertyName":"entityType","mapping":{"message":"#/components/schemas/InsertMessageEvent","conversation":"#/components/schemas/InsertConversationEvent","search":"#/components/schemas/InsertSearchEvent"}}},"QueryConversationsResponseData":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userMessageCount":{"type":"number"},"organizationId":{"type":["string","null"]},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"firstMessageTime":{"type":"string","format":"date-time"},"type":{"type":["string","null"],"enum":["openai","support_ticket","support_copilot"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"sum":{"type":"number"},"count":{"type":"number"},"avg":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"id_hour":{"type":"string"},"id_day":{"type":"string"},"id_week":{"type":"string"},"id_month":{"type":"string"},"userMessageCount_hour":{"type":"string"},"userMessageCount_day":{"type":"string"},"userMessageCount_week":{"type":"string"},"userMessageCount_month":{"type":"string"},"organizationId_hour":{"type":"string"},"organizationId_day":{"type":"string"},"organizationId_week":{"type":"string"},"organizationId_month":{"type":"string"},"projectId_hour":{"type":"string"},"projectId_day":{"type":"string"},"projectId_week":{"type":"string"},"projectId_month":{"type":"string"},"integrationId_hour":{"type":"string"},"integrationId_day":{"type":"string"},"integrationId_week":{"type":"string"},"integrationId_month":{"type":"string"},"firstMessageTime_hour":{"type":"string"},"firstMessageTime_day":{"type":"string"},"firstMessageTime_week":{"type":"string"},"firstMessageTime_month":{"type":"string"},"type_hour":{"type":"string"},"type_day":{"type":"string"},"type_week":{"type":"string"},"type_month":{"type":"string"},"properties_hour":{"type":"string"},"properties_day":{"type":"string"},"properties_week":{"type":"string"},"properties_month":{"type":"string"},"userProperties_hour":{"type":"string"},"userProperties_day":{"type":"string"},"userProperties_week":{"type":"string"},"userProperties_month":{"type":"string"},"sum_id":{"type":"number"},"sum_userMessageCount":{"type":"number"},"sum_organizationId":{"type":"number"},"sum_projectId":{"type":"number"},"sum_integrationId":{"type":"number"},"sum_firstMessageTime":{"type":"number"},"sum_type":{"type":"number"},"sum_properties":{"type":"number"},"sum_userProperties":{"type":"number"},"count_id":{"type":"number"},"count_userMessageCount":{"type":"number"},"count_organizationId":{"type":"number"},"count_projectId":{"type":"number"},"count_integrationId":{"type":"number"},"count_firstMessageTime":{"type":"number"},"count_type":{"type":"number"},"count_properties":{"type":"number"},"count_userProperties":{"type":"number"},"avg_id":{"type":"number"},"avg_userMessageCount":{"type":"number"},"avg_organizationId":{"type":"number"},"avg_projectId":{"type":"number"},"avg_integrationId":{"type":"number"},"avg_firstMessageTime":{"type":"number"},"avg_type":{"type":"number"},"avg_properties":{"type":"number"},"avg_userProperties":{"type":"number"},"min_id":{"type":"number"},"min_userMessageCount":{"type":"number"},"min_organizationId":{"type":"number"},"min_projectId":{"type":"number"},"min_integrationId":{"type":"number"},"min_firstMessageTime":{"type":"number"},"min_type":{"type":"number"},"min_properties":{"type":"number"},"min_userProperties":{"type":"number"},"max_id":{"type":"number"},"max_userMessageCount":{"type":"number"},"max_organizationId":{"type":"number"},"max_projectId":{"type":"number"},"max_integrationId":{"type":"number"},"max_firstMessageTime":{"type":"number"},"max_type":{"type":"number"},"max_properties":{"type":"number"},"max_userProperties":{"type":"number"},"sum_properties.userId":{"type":"number"},"sum_properties.supportAgentName":{"type":"number"},"sum_userProperties.userId":{"type":"number"},"sum_userProperties.supportAgentName":{"type":"number"},"count_properties.userId":{"type":"number"},"count_properties.supportAgentName":{"type":"number"},"count_userProperties.userId":{"type":"number"},"count_userProperties.supportAgentName":{"type":"number"},"countDistinct_properties.userId":{"type":"number"},"countDistinct_properties.supportAgentName":{"type":"number"},"countDistinct_userProperties.userId":{"type":"number"},"countDistinct_userProperties.supportAgentName":{"type":"number"},"avg_properties.userId":{"type":"number"},"avg_properties.supportAgentName":{"type":"number"},"avg_userProperties.userId":{"type":"number"},"avg_userProperties.supportAgentName":{"type":"number"},"min_properties.userId":{"type":"number"},"min_properties.supportAgentName":{"type":"number"},"min_userProperties.userId":{"type":"number"},"min_userProperties.supportAgentName":{"type":"number"},"max_properties.userId":{"type":"number"},"max_properties.supportAgentName":{"type":"number"},"max_userProperties.userId":{"type":"number"},"max_userProperties.supportAgentName":{"type":"number"},"properties.userId":{"type":["string","null"]},"properties.supportAgentName":{"type":["string","null"]},"userProperties.userId":{"type":["string","null"]},"userProperties.supportAgentName":{"type":["string","null"]}},"additionalProperties":true,"title":"ConversationsResultItem"}},"total":{"type":"number","description":"Total number of results matching the query"},"pageSize":{"type":"number","description":"Number of results per page"},"count":{"type":"number","description":"Number of results in the current response"}},"required":["result","total","pageSize","count"],"description":"Data object containing QueryConversations query results and pagination information"},"QueryConversationsResponseBody":{"type":"object","properties":{"status":{"type":"string","enum":["ok"],"description":"Status of the response"},"data":{"$ref":"#/components/schemas/QueryConversationsResponseData"}},"required":["status","data"],"description":"Response body for QueryConversations query endpoint"},"ConversationsAggregationSelection":{"type":"object","properties":{"type":{"type":"string","enum":["aggregation"]},"aggregation":{"type":"string","enum":["sum","count","countDistinct","avg","min","max"]},"field":{"type":"string","enum":["id","userMessageCount","organizationId","projectId","integrationId","firstMessageTime","type","properties","userProperties"]},"path":{"type":"array","items":{"type":"string"}}},"required":["type","aggregation"],"title":"ConversationsAggregationSelection"},"TimeUnit":{"type":"string","enum":["hour","day","week","month"],"description":"Valid time units for time-based operations","title":"Time Unit"},"ConversationsTimeBasedGroupBySelection":{"type":"object","properties":{"type":{"type":"string","enum":["time"]},"timeUnit":{"$ref":"#/components/schemas/TimeUnit"},"field":{"type":"string","enum":["id","userMessageCount","organizationId","projectId","integrationId","firstMessageTime","type","properties","userProperties"]}},"required":["type","timeUnit"],"title":"ConversationsTimeBasedGroupBySelection"},"ConversationsSimpleFieldSelection":{"type":"object","properties":{"type":{"type":"string","enum":["field"]},"field":{"type":"string","enum":["id","userMessageCount","organizationId","projectId","integrationId","firstMessageTime","type","properties","userProperties"]},"path":{"type":"array","items":{"type":"string"},"description":"Path to a nested property within a JSON field. Cannot be used when mode is \"json\"."},"mode":{"type":"string","enum":["unpack","json"],"description":"Export mode for JSON/array fields. \"unpack\" (default): Flattens JSON into separate columns (e.g., properties.key1, properties.key2). \"json\": Exports the entire JSON object as a single stringified column. Applicable to: properties, userProperties, and for feedback exports: reasons, sources."}},"required":["type","field"],"title":"ConversationsSimpleFieldSelection"},"ConversationsSelection":{"anyOf":[{"$ref":"#/components/schemas/ConversationsAggregationSelection"},{"$ref":"#/components/schemas/ConversationsTimeBasedGroupBySelection"},{"$ref":"#/components/schemas/ConversationsSimpleFieldSelection"}],"description":"Fields to select from conversations","oneOf":[{"$ref":"#/components/schemas/ConversationsAggregationSelection"},{"$ref":"#/components/schemas/ConversationsTimeBasedGroupBySelection"},{"$ref":"#/components/schemas/ConversationsSimpleFieldSelection"}],"discriminator":{"propertyName":"type","mapping":{"aggregation":"#/components/schemas/ConversationsAggregationSelection","time":"#/components/schemas/ConversationsTimeBasedGroupBySelection","field":"#/components/schemas/ConversationsSimpleFieldSelection"}},"title":"ConversationsSelection"},"ConversationsField":{"type":"string","enum":["id","userMessageCount","organizationId","projectId","integrationId","firstMessageTime","type","properties","userProperties"],"description":"Available fields for Conversations","title":"ConversationsField"},"ConversationsGroupBy":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/ConversationsField"},"path":{"type":"array","items":{"type":"string"}},"includeInSelect":{"type":"boolean","default":true}},"required":["field"],"description":"Group by options for conversations","title":"ConversationsGroupBy"},"FilterOperator":{"type":"string","enum":["eq","neq","gt","gte","lt","lte","in","notIn","arrayContains","jsonContains","jsonContainedBy","jsonHasKey","jsonArrayContainsObject","jsonHasAnyKey","jsonHasAllKeys","isNull","isNotNull"],"description":"Available operators for filtering data","title":"Filter Operators"},"ConversationsFilterConditionValue":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"number"},{"type":"array","items":{"type":"string"}},{"type":"string"},{"type":"object","additionalProperties":{}},{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"null"}]}},{"type":"null"}]}},"required":["path","value"]}],"description":"The value to compare the field against. For JSON fields, can be either a JSON object or a {path, value} pair."},"ConversationsFilterCondition":{"type":"object","properties":{"condition":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/ConversationsField"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"value":{"$ref":"#/components/schemas/ConversationsFilterConditionValue"}},"required":["field","operator","value"]}},"required":["condition"],"title":"ConversationsFilter Condition"},"ConversationsFilterAND":{"type":"object","properties":{"and":{"type":"array","description":"ConversationsFilter AND condition","title":"ConversationsFilter AND condition","items":{"oneOf":[{"$ref":"#/components/schemas/ConversationsFilter"}]}}},"required":["and"],"description":"ConversationsFilter AND operator","title":"ConversationsFilter AND operator"},"ConversationsFilterOR":{"type":"object","properties":{"or":{"type":"array","description":"ConversationsFilter OR condition","items":{"oneOf":[{"$ref":"#/components/schemas/ConversationsFilter"}]}}},"required":["or"],"description":"ConversationsFilter OR operator","title":"ConversationsFilter OR operator"},"ConversationsFilter":{"anyOf":[{"$ref":"#/components/schemas/ConversationsFilterCondition"},{"$ref":"#/components/schemas/ConversationsFilterAND"},{"$ref":"#/components/schemas/ConversationsFilterOR"}],"title":"ConversationsFilter"},"ConversationsOrderBy":{"type":"object","properties":{"field":{"type":"string","enum":["id","userMessageCount","organizationId","projectId","integrationId","firstMessageTime","type","properties","userProperties","id_hour","id_day","id_week","id_month","userMessageCount_hour","userMessageCount_day","userMessageCount_week","userMessageCount_month","organizationId_hour","organizationId_day","organizationId_week","organizationId_month","projectId_hour","projectId_day","projectId_week","projectId_month","integrationId_hour","integrationId_day","integrationId_week","integrationId_month","firstMessageTime_hour","firstMessageTime_day","firstMessageTime_week","firstMessageTime_month","type_hour","type_day","type_week","type_month","properties_hour","properties_day","properties_week","properties_month","userProperties_hour","userProperties_day","userProperties_week","userProperties_month","sum_id","sum_userMessageCount","sum_organizationId","sum_projectId","sum_integrationId","sum_firstMessageTime","sum_type","sum_properties","sum_userProperties","count_id","count_userMessageCount","count_organizationId","count_projectId","count_integrationId","count_firstMessageTime","count_type","count_properties","count_userProperties","avg_id","avg_userMessageCount","avg_organizationId","avg_projectId","avg_integrationId","avg_firstMessageTime","avg_type","avg_properties","avg_userProperties","min_id","min_userMessageCount","min_organizationId","min_projectId","min_integrationId","min_firstMessageTime","min_type","min_properties","min_userProperties","max_id","max_userMessageCount","max_organizationId","max_projectId","max_integrationId","max_firstMessageTime","max_type","max_properties","max_userProperties"]},"direction":{"type":"string","enum":["asc","desc"]}},"required":["field","direction"],"description":"Specifies how to order Conversations query results by field and direction","title":"Conversations OrderBy Schema"},"QueryConversationsRequestBody":{"type":"object","properties":{"select":{"type":"array","items":{"$ref":"#/components/schemas/ConversationsSelection"}},"groupBy":{"type":"array","items":{"$ref":"#/components/schemas/ConversationsGroupBy"}},"where":{"$ref":"#/components/schemas/ConversationsFilter"},"orderBy":{"type":"array","items":{"$ref":"#/components/schemas/ConversationsOrderBy"}},"notes":{"type":"string","maxLength":80,"description":"Notes are not persisted, but may be useful for your debugging purposes","example":"Count of support ticket conversations by integration"}},"description":"Query Conversations Params","title":"QueryConversationsRequestBody"},"QueryEventsResponseData":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"messageId":{"type":"string"},"conversationId":{"type":"string"},"createdAt":{"type":"string"},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"eventType":{"type":"string"},"type":{"type":"string"},"searchQuery":{"type":"string"},"properties":{"type":["object","null"],"additionalProperties":{"type":"string"}},"userProperties":{"type":["object","null"],"additionalProperties":{"type":"string"}},"sum":{"type":"number"},"count":{"type":"number"},"avg":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"id_hour":{"type":"string"},"id_day":{"type":"string"},"id_week":{"type":"string"},"id_month":{"type":"string"},"organizationId_hour":{"type":"string"},"organizationId_day":{"type":"string"},"organizationId_week":{"type":"string"},"organizationId_month":{"type":"string"},"messageId_hour":{"type":"string"},"messageId_day":{"type":"string"},"messageId_week":{"type":"string"},"messageId_month":{"type":"string"},"conversationId_hour":{"type":"string"},"conversationId_day":{"type":"string"},"conversationId_week":{"type":"string"},"conversationId_month":{"type":"string"},"createdAt_hour":{"type":"string"},"createdAt_day":{"type":"string"},"createdAt_week":{"type":"string"},"createdAt_month":{"type":"string"},"projectId_hour":{"type":"string"},"projectId_day":{"type":"string"},"projectId_week":{"type":"string"},"projectId_month":{"type":"string"},"integrationId_hour":{"type":"string"},"integrationId_day":{"type":"string"},"integrationId_week":{"type":"string"},"integrationId_month":{"type":"string"},"eventType_hour":{"type":"string"},"eventType_day":{"type":"string"},"eventType_week":{"type":"string"},"eventType_month":{"type":"string"},"type_hour":{"type":"string"},"type_day":{"type":"string"},"type_week":{"type":"string"},"type_month":{"type":"string"},"searchQuery_hour":{"type":"string"},"searchQuery_day":{"type":"string"},"searchQuery_week":{"type":"string"},"searchQuery_month":{"type":"string"},"properties_hour":{"type":"string"},"properties_day":{"type":"string"},"properties_week":{"type":"string"},"properties_month":{"type":"string"},"userProperties_hour":{"type":"string"},"userProperties_day":{"type":"string"},"userProperties_week":{"type":"string"},"userProperties_month":{"type":"string"},"sum_id":{"type":"number"},"sum_organizationId":{"type":"number"},"sum_messageId":{"type":"number"},"sum_conversationId":{"type":"number"},"sum_createdAt":{"type":"number"},"sum_projectId":{"type":"number"},"sum_integrationId":{"type":"number"},"sum_eventType":{"type":"number"},"sum_type":{"type":"number"},"sum_searchQuery":{"type":"number"},"sum_properties":{"type":"number"},"sum_userProperties":{"type":"number"},"count_id":{"type":"number"},"count_organizationId":{"type":"number"},"count_messageId":{"type":"number"},"count_conversationId":{"type":"number"},"count_createdAt":{"type":"number"},"count_projectId":{"type":"number"},"count_integrationId":{"type":"number"},"count_eventType":{"type":"number"},"count_type":{"type":"number"},"count_searchQuery":{"type":"number"},"count_properties":{"type":"number"},"count_userProperties":{"type":"number"},"avg_id":{"type":"number"},"avg_organizationId":{"type":"number"},"avg_messageId":{"type":"number"},"avg_conversationId":{"type":"number"},"avg_createdAt":{"type":"number"},"avg_projectId":{"type":"number"},"avg_integrationId":{"type":"number"},"avg_eventType":{"type":"number"},"avg_type":{"type":"number"},"avg_searchQuery":{"type":"number"},"avg_properties":{"type":"number"},"avg_userProperties":{"type":"number"},"min_id":{"type":"number"},"min_organizationId":{"type":"number"},"min_messageId":{"type":"number"},"min_conversationId":{"type":"number"},"min_createdAt":{"type":"number"},"min_projectId":{"type":"number"},"min_integrationId":{"type":"number"},"min_eventType":{"type":"number"},"min_type":{"type":"number"},"min_searchQuery":{"type":"number"},"min_properties":{"type":"number"},"min_userProperties":{"type":"number"},"max_id":{"type":"number"},"max_organizationId":{"type":"number"},"max_messageId":{"type":"number"},"max_conversationId":{"type":"number"},"max_createdAt":{"type":"number"},"max_projectId":{"type":"number"},"max_integrationId":{"type":"number"},"max_eventType":{"type":"number"},"max_type":{"type":"number"},"max_searchQuery":{"type":"number"},"max_properties":{"type":"number"},"max_userProperties":{"type":"number"},"sum_properties.userId":{"type":"number"},"sum_properties.supportAgentName":{"type":"number"},"sum_userProperties.userId":{"type":"number"},"sum_userProperties.supportAgentName":{"type":"number"},"count_properties.userId":{"type":"number"},"count_properties.supportAgentName":{"type":"number"},"count_userProperties.userId":{"type":"number"},"count_userProperties.supportAgentName":{"type":"number"},"countDistinct_properties.userId":{"type":"number"},"countDistinct_properties.supportAgentName":{"type":"number"},"countDistinct_userProperties.userId":{"type":"number"},"countDistinct_userProperties.supportAgentName":{"type":"number"},"avg_properties.userId":{"type":"number"},"avg_properties.supportAgentName":{"type":"number"},"avg_userProperties.userId":{"type":"number"},"avg_userProperties.supportAgentName":{"type":"number"},"min_properties.userId":{"type":"number"},"min_properties.supportAgentName":{"type":"number"},"min_userProperties.userId":{"type":"number"},"min_userProperties.supportAgentName":{"type":"number"},"max_properties.userId":{"type":"number"},"max_properties.supportAgentName":{"type":"number"},"max_userProperties.userId":{"type":"number"},"max_userProperties.supportAgentName":{"type":"number"},"properties.userId":{"type":["string","null"]},"properties.supportAgentName":{"type":["string","null"]},"userProperties.userId":{"type":["string","null"]},"userProperties.supportAgentName":{"type":["string","null"]}},"additionalProperties":true,"title":"EventsResultItem"}},"total":{"type":"number","description":"Total number of results matching the query"},"pageSize":{"type":"number","description":"Number of results per page"},"count":{"type":"number","description":"Number of results in the current response"}},"required":["result","total","pageSize","count"],"description":"Data object containing QueryEvents query results and pagination information"},"QueryEventsResponseBody":{"type":"object","properties":{"status":{"type":"string","enum":["ok"],"description":"Status of the response"},"data":{"$ref":"#/components/schemas/QueryEventsResponseData"}},"required":["status","data"],"description":"Response body for QueryEvents query endpoint"},"EventsAggregationSelection":{"type":"object","properties":{"type":{"type":"string","enum":["aggregation"]},"aggregation":{"type":"string","enum":["sum","count","countDistinct","avg","min","max"]},"field":{"type":"string","enum":["id","organizationId","messageId","conversationId","createdAt","projectId","integrationId","eventType","type","searchQuery","properties","userProperties"]},"path":{"type":"array","items":{"type":"string"}}},"required":["type","aggregation"],"title":"EventsAggregationSelection"},"EventsTimeBasedGroupBySelection":{"type":"object","properties":{"type":{"type":"string","enum":["time"]},"timeUnit":{"$ref":"#/components/schemas/TimeUnit"},"field":{"type":"string","enum":["id","organizationId","messageId","conversationId","createdAt","projectId","integrationId","eventType","type","searchQuery","properties","userProperties"]}},"required":["type","timeUnit"],"title":"EventsTimeBasedGroupBySelection"},"EventsSimpleFieldSelection":{"type":"object","properties":{"type":{"type":"string","enum":["field"]},"field":{"type":"string","enum":["id","organizationId","messageId","conversationId","createdAt","projectId","integrationId","eventType","type","searchQuery","properties","userProperties"]},"path":{"type":"array","items":{"type":"string"},"description":"Path to a nested property within a JSON field. Cannot be used when mode is \"json\"."},"mode":{"type":"string","enum":["unpack","json"],"description":"Export mode for JSON/array fields. \"unpack\" (default): Flattens JSON into separate columns (e.g., properties.key1, properties.key2). \"json\": Exports the entire JSON object as a single stringified column. Applicable to: properties, userProperties, and for feedback exports: reasons, sources."}},"required":["type","field"],"title":"EventsSimpleFieldSelection"},"EventsSelection":{"anyOf":[{"$ref":"#/components/schemas/EventsAggregationSelection"},{"$ref":"#/components/schemas/EventsTimeBasedGroupBySelection"},{"$ref":"#/components/schemas/EventsSimpleFieldSelection"}],"description":"Fields to select from events","oneOf":[{"$ref":"#/components/schemas/EventsAggregationSelection"},{"$ref":"#/components/schemas/EventsTimeBasedGroupBySelection"},{"$ref":"#/components/schemas/EventsSimpleFieldSelection"}],"discriminator":{"propertyName":"type","mapping":{"aggregation":"#/components/schemas/EventsAggregationSelection","time":"#/components/schemas/EventsTimeBasedGroupBySelection","field":"#/components/schemas/EventsSimpleFieldSelection"}},"title":"EventsSelection"},"EventsField":{"type":"string","enum":["id","organizationId","messageId","conversationId","createdAt","projectId","integrationId","eventType","type","searchQuery","properties","userProperties"],"description":"Available fields for Events","title":"EventsField"},"EventsGroupBy":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/EventsField"},"path":{"type":"array","items":{"type":"string"}},"includeInSelect":{"type":"boolean","default":true}},"required":["field"],"description":"Group by options for events","title":"EventsGroupBy"},"EventsFilterConditionValue":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"number"},{"type":"array","items":{"type":"string"}},{"type":"string"},{"type":"object","additionalProperties":{}},{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"null"}]}},{"type":"null"}]}},"required":["path","value"]}],"description":"The value to compare the field against. For JSON fields, can be either a JSON object or a {path, value} pair."},"EventsFilterCondition":{"type":"object","properties":{"condition":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/EventsField"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"value":{"$ref":"#/components/schemas/EventsFilterConditionValue"}},"required":["field","operator","value"]}},"required":["condition"],"title":"EventsFilter Condition"},"EventsFilterAND":{"type":"object","properties":{"and":{"type":"array","description":"EventsFilter AND condition","title":"EventsFilter AND condition","items":{"oneOf":[{"$ref":"#/components/schemas/EventsFilter"}]}}},"required":["and"],"description":"EventsFilter AND operator","title":"EventsFilter AND operator"},"EventsFilterOR":{"type":"object","properties":{"or":{"type":"array","description":"EventsFilter OR condition","items":{"oneOf":[{"$ref":"#/components/schemas/EventsFilter"}]}}},"required":["or"],"description":"EventsFilter OR operator","title":"EventsFilter OR operator"},"EventsFilter":{"anyOf":[{"$ref":"#/components/schemas/EventsFilterCondition"},{"$ref":"#/components/schemas/EventsFilterAND"},{"$ref":"#/components/schemas/EventsFilterOR"}],"title":"EventsFilter"},"EventsOrderBy":{"type":"object","properties":{"field":{"type":"string","enum":["id","organizationId","messageId","conversationId","createdAt","projectId","integrationId","eventType","type","searchQuery","properties","userProperties","id_hour","id_day","id_week","id_month","organizationId_hour","organizationId_day","organizationId_week","organizationId_month","messageId_hour","messageId_day","messageId_week","messageId_month","conversationId_hour","conversationId_day","conversationId_week","conversationId_month","createdAt_hour","createdAt_day","createdAt_week","createdAt_month","projectId_hour","projectId_day","projectId_week","projectId_month","integrationId_hour","integrationId_day","integrationId_week","integrationId_month","eventType_hour","eventType_day","eventType_week","eventType_month","type_hour","type_day","type_week","type_month","searchQuery_hour","searchQuery_day","searchQuery_week","searchQuery_month","properties_hour","properties_day","properties_week","properties_month","userProperties_hour","userProperties_day","userProperties_week","userProperties_month","sum_id","sum_organizationId","sum_messageId","sum_conversationId","sum_createdAt","sum_projectId","sum_integrationId","sum_eventType","sum_type","sum_searchQuery","sum_properties","sum_userProperties","count_id","count_organizationId","count_messageId","count_conversationId","count_createdAt","count_projectId","count_integrationId","count_eventType","count_type","count_searchQuery","count_properties","count_userProperties","avg_id","avg_organizationId","avg_messageId","avg_conversationId","avg_createdAt","avg_projectId","avg_integrationId","avg_eventType","avg_type","avg_searchQuery","avg_properties","avg_userProperties","min_id","min_organizationId","min_messageId","min_conversationId","min_createdAt","min_projectId","min_integrationId","min_eventType","min_type","min_searchQuery","min_properties","min_userProperties","max_id","max_organizationId","max_messageId","max_conversationId","max_createdAt","max_projectId","max_integrationId","max_eventType","max_type","max_searchQuery","max_properties","max_userProperties"]},"direction":{"type":"string","enum":["asc","desc"]}},"required":["field","direction"],"description":"Specifies how to order Events query results by field and direction","title":"Events OrderBy Schema"},"QueryEventsRequestBody":{"type":"object","properties":{"select":{"type":"array","items":{"$ref":"#/components/schemas/EventsSelection"}},"groupBy":{"type":"array","items":{"$ref":"#/components/schemas/EventsGroupBy"}},"where":{"$ref":"#/components/schemas/EventsFilter"},"orderBy":{"type":"array","items":{"$ref":"#/components/schemas/EventsOrderBy"}},"notes":{"type":"string","maxLength":80,"description":"Notes are not persisted, but may be useful for your debugging purposes","example":"Count of events by type"}},"description":"Query Events Params","title":"QueryEventsRequestBody"},"QueryFeedbackResponseData":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["positive","negative"]},"messageId":{"type":"string"},"createdAt":{},"updatedAt":{},"organizationId":{"type":"string"},"reasons":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":"string"},"details":{"type":"string"}},"required":["label","details"]}},"sources":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":["string","null"],"enum":["positive","negative","new"]},"title":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["type"]}},"details":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"conversationId":{"type":"string"},"projectId":{"type":["string","null"]},"integrationId":{"type":["string","null"]},"sum":{"type":"number"},"count":{"type":"number"},"avg":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"id_hour":{"type":"string"},"id_day":{"type":"string"},"id_week":{"type":"string"},"id_month":{"type":"string"},"type_hour":{"type":"string"},"type_day":{"type":"string"},"type_week":{"type":"string"},"type_month":{"type":"string"},"messageId_hour":{"type":"string"},"messageId_day":{"type":"string"},"messageId_week":{"type":"string"},"messageId_month":{"type":"string"},"createdAt_hour":{"type":"string"},"createdAt_day":{"type":"string"},"createdAt_week":{"type":"string"},"createdAt_month":{"type":"string"},"updatedAt_hour":{"type":"string"},"updatedAt_day":{"type":"string"},"updatedAt_week":{"type":"string"},"updatedAt_month":{"type":"string"},"organizationId_hour":{"type":"string"},"organizationId_day":{"type":"string"},"organizationId_week":{"type":"string"},"organizationId_month":{"type":"string"},"reasons_hour":{"type":"string"},"reasons_day":{"type":"string"},"reasons_week":{"type":"string"},"reasons_month":{"type":"string"},"sources_hour":{"type":"string"},"sources_day":{"type":"string"},"sources_week":{"type":"string"},"sources_month":{"type":"string"},"details_hour":{"type":"string"},"details_day":{"type":"string"},"details_week":{"type":"string"},"details_month":{"type":"string"},"properties_hour":{"type":"string"},"properties_day":{"type":"string"},"properties_week":{"type":"string"},"properties_month":{"type":"string"},"userProperties_hour":{"type":"string"},"userProperties_day":{"type":"string"},"userProperties_week":{"type":"string"},"userProperties_month":{"type":"string"},"conversationId_hour":{"type":"string"},"conversationId_day":{"type":"string"},"conversationId_week":{"type":"string"},"conversationId_month":{"type":"string"},"projectId_hour":{"type":"string"},"projectId_day":{"type":"string"},"projectId_week":{"type":"string"},"projectId_month":{"type":"string"},"integrationId_hour":{"type":"string"},"integrationId_day":{"type":"string"},"integrationId_week":{"type":"string"},"integrationId_month":{"type":"string"},"sum_id":{"type":"number"},"sum_type":{"type":"number"},"sum_messageId":{"type":"number"},"sum_createdAt":{"type":"number"},"sum_updatedAt":{"type":"number"},"sum_organizationId":{"type":"number"},"sum_reasons":{"type":"number"},"sum_sources":{"type":"number"},"sum_details":{"type":"number"},"sum_properties":{"type":"number"},"sum_userProperties":{"type":"number"},"sum_conversationId":{"type":"number"},"sum_projectId":{"type":"number"},"sum_integrationId":{"type":"number"},"count_id":{"type":"number"},"count_type":{"type":"number"},"count_messageId":{"type":"number"},"count_createdAt":{"type":"number"},"count_updatedAt":{"type":"number"},"count_organizationId":{"type":"number"},"count_reasons":{"type":"number"},"count_sources":{"type":"number"},"count_details":{"type":"number"},"count_properties":{"type":"number"},"count_userProperties":{"type":"number"},"count_conversationId":{"type":"number"},"count_projectId":{"type":"number"},"count_integrationId":{"type":"number"},"avg_id":{"type":"number"},"avg_type":{"type":"number"},"avg_messageId":{"type":"number"},"avg_createdAt":{"type":"number"},"avg_updatedAt":{"type":"number"},"avg_organizationId":{"type":"number"},"avg_reasons":{"type":"number"},"avg_sources":{"type":"number"},"avg_details":{"type":"number"},"avg_properties":{"type":"number"},"avg_userProperties":{"type":"number"},"avg_conversationId":{"type":"number"},"avg_projectId":{"type":"number"},"avg_integrationId":{"type":"number"},"min_id":{"type":"number"},"min_type":{"type":"number"},"min_messageId":{"type":"number"},"min_createdAt":{"type":"number"},"min_updatedAt":{"type":"number"},"min_organizationId":{"type":"number"},"min_reasons":{"type":"number"},"min_sources":{"type":"number"},"min_details":{"type":"number"},"min_properties":{"type":"number"},"min_userProperties":{"type":"number"},"min_conversationId":{"type":"number"},"min_projectId":{"type":"number"},"min_integrationId":{"type":"number"},"max_id":{"type":"number"},"max_type":{"type":"number"},"max_messageId":{"type":"number"},"max_createdAt":{"type":"number"},"max_updatedAt":{"type":"number"},"max_organizationId":{"type":"number"},"max_reasons":{"type":"number"},"max_sources":{"type":"number"},"max_details":{"type":"number"},"max_properties":{"type":"number"},"max_userProperties":{"type":"number"},"max_conversationId":{"type":"number"},"max_projectId":{"type":"number"},"max_integrationId":{"type":"number"},"sum_properties.userId":{"type":"number"},"sum_properties.supportAgentName":{"type":"number"},"sum_userProperties.userId":{"type":"number"},"sum_userProperties.supportAgentName":{"type":"number"},"count_properties.userId":{"type":"number"},"count_properties.supportAgentName":{"type":"number"},"count_userProperties.userId":{"type":"number"},"count_userProperties.supportAgentName":{"type":"number"},"countDistinct_properties.userId":{"type":"number"},"countDistinct_properties.supportAgentName":{"type":"number"},"countDistinct_userProperties.userId":{"type":"number"},"countDistinct_userProperties.supportAgentName":{"type":"number"},"avg_properties.userId":{"type":"number"},"avg_properties.supportAgentName":{"type":"number"},"avg_userProperties.userId":{"type":"number"},"avg_userProperties.supportAgentName":{"type":"number"},"min_properties.userId":{"type":"number"},"min_properties.supportAgentName":{"type":"number"},"min_userProperties.userId":{"type":"number"},"min_userProperties.supportAgentName":{"type":"number"},"max_properties.userId":{"type":"number"},"max_properties.supportAgentName":{"type":"number"},"max_userProperties.userId":{"type":"number"},"max_userProperties.supportAgentName":{"type":"number"},"properties.userId":{"type":["string","null"]},"properties.supportAgentName":{"type":["string","null"]},"userProperties.userId":{"type":["string","null"]},"userProperties.supportAgentName":{"type":["string","null"]}},"additionalProperties":true,"title":"FeedbackResultItem"}},"total":{"type":"number","description":"Total number of results matching the query"},"pageSize":{"type":"number","description":"Number of results per page"},"count":{"type":"number","description":"Number of results in the current response"}},"required":["result","total","pageSize","count"],"description":"Data object containing QueryFeedback query results and pagination information"},"QueryFeedbackResponseBody":{"type":"object","properties":{"status":{"type":"string","enum":["ok"],"description":"Status of the response"},"data":{"$ref":"#/components/schemas/QueryFeedbackResponseData"}},"required":["status","data"],"description":"Response body for QueryFeedback query endpoint"},"FeedbackAggregationSelection":{"type":"object","properties":{"type":{"type":"string","enum":["aggregation"]},"aggregation":{"type":"string","enum":["sum","count","countDistinct","avg","min","max"]},"field":{"type":"string","enum":["id","type","messageId","createdAt","updatedAt","organizationId","reasons","sources","details","properties","userProperties","conversationId","projectId","integrationId"]},"path":{"type":"array","items":{"type":"string"}}},"required":["type","aggregation"],"title":"FeedbackAggregationSelection"},"FeedbackTimeBasedGroupBySelection":{"type":"object","properties":{"type":{"type":"string","enum":["time"]},"timeUnit":{"$ref":"#/components/schemas/TimeUnit"},"field":{"type":"string","enum":["id","type","messageId","createdAt","updatedAt","organizationId","reasons","sources","details","properties","userProperties","conversationId","projectId","integrationId"]}},"required":["type","timeUnit"],"title":"FeedbackTimeBasedGroupBySelection"},"FeedbackSimpleFieldSelection":{"type":"object","properties":{"type":{"type":"string","enum":["field"]},"field":{"type":"string","enum":["id","type","messageId","createdAt","updatedAt","organizationId","reasons","sources","details","properties","userProperties","conversationId","projectId","integrationId"]},"path":{"type":"array","items":{"type":"string"},"description":"Path to a nested property within a JSON field. Cannot be used when mode is \"json\"."},"mode":{"type":"string","enum":["unpack","json"],"description":"Export mode for JSON/array fields. \"unpack\" (default): Flattens JSON into separate columns (e.g., properties.key1, properties.key2). \"json\": Exports the entire JSON object as a single stringified column. Applicable to: properties, userProperties, and for feedback exports: reasons, sources."}},"required":["type","field"],"title":"FeedbackSimpleFieldSelection"},"FeedbackSelection":{"anyOf":[{"$ref":"#/components/schemas/FeedbackAggregationSelection"},{"$ref":"#/components/schemas/FeedbackTimeBasedGroupBySelection"},{"$ref":"#/components/schemas/FeedbackSimpleFieldSelection"}],"description":"Fields to select from feedback","oneOf":[{"$ref":"#/components/schemas/FeedbackAggregationSelection"},{"$ref":"#/components/schemas/FeedbackTimeBasedGroupBySelection"},{"$ref":"#/components/schemas/FeedbackSimpleFieldSelection"}],"discriminator":{"propertyName":"type","mapping":{"aggregation":"#/components/schemas/FeedbackAggregationSelection","time":"#/components/schemas/FeedbackTimeBasedGroupBySelection","field":"#/components/schemas/FeedbackSimpleFieldSelection"}},"title":"FeedbackSelection"},"FeedbackField":{"type":"string","enum":["id","type","messageId","createdAt","updatedAt","organizationId","reasons","sources","details","properties","userProperties","conversationId","projectId","integrationId"],"description":"Available fields for Feedback","title":"FeedbackField"},"FeedbackGroupBy":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/FeedbackField"},"path":{"type":"array","items":{"type":"string"}},"includeInSelect":{"type":"boolean","default":true}},"required":["field"],"description":"Group by options for feedback","title":"FeedbackGroupBy"},"FeedbackFilterConditionValue":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"number"},{"type":"array","items":{"type":"string"}},{"type":"string"},{"type":"object","additionalProperties":{}},{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"null"}]}},{"type":"null"}]}},"required":["path","value"]}],"description":"The value to compare the field against. For JSON fields, can be either a JSON object or a {path, value} pair."},"FeedbackFilterCondition":{"type":"object","properties":{"condition":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/FeedbackField"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"value":{"$ref":"#/components/schemas/FeedbackFilterConditionValue"}},"required":["field","operator","value"]}},"required":["condition"],"title":"FeedbackFilter Condition"},"FeedbackFilterAND":{"type":"object","properties":{"and":{"type":"array","description":"FeedbackFilter AND condition","title":"FeedbackFilter AND condition","items":{"oneOf":[{"$ref":"#/components/schemas/FeedbackFilter"}]}}},"required":["and"],"description":"FeedbackFilter AND operator","title":"FeedbackFilter AND operator"},"FeedbackFilterOR":{"type":"object","properties":{"or":{"type":"array","description":"FeedbackFilter OR condition","items":{"oneOf":[{"$ref":"#/components/schemas/FeedbackFilter"}]}}},"required":["or"],"description":"FeedbackFilter OR operator","title":"FeedbackFilter OR operator"},"FeedbackFilter":{"anyOf":[{"$ref":"#/components/schemas/FeedbackFilterCondition"},{"$ref":"#/components/schemas/FeedbackFilterAND"},{"$ref":"#/components/schemas/FeedbackFilterOR"}],"title":"FeedbackFilter"},"FeedbackOrderBy":{"type":"object","properties":{"field":{"type":"string","enum":["id","type","messageId","createdAt","updatedAt","organizationId","reasons","sources","details","properties","userProperties","conversationId","projectId","integrationId","id_hour","id_day","id_week","id_month","type_hour","type_day","type_week","type_month","messageId_hour","messageId_day","messageId_week","messageId_month","createdAt_hour","createdAt_day","createdAt_week","createdAt_month","updatedAt_hour","updatedAt_day","updatedAt_week","updatedAt_month","organizationId_hour","organizationId_day","organizationId_week","organizationId_month","reasons_hour","reasons_day","reasons_week","reasons_month","sources_hour","sources_day","sources_week","sources_month","details_hour","details_day","details_week","details_month","properties_hour","properties_day","properties_week","properties_month","userProperties_hour","userProperties_day","userProperties_week","userProperties_month","conversationId_hour","conversationId_day","conversationId_week","conversationId_month","projectId_hour","projectId_day","projectId_week","projectId_month","integrationId_hour","integrationId_day","integrationId_week","integrationId_month","sum_id","sum_type","sum_messageId","sum_createdAt","sum_updatedAt","sum_organizationId","sum_reasons","sum_sources","sum_details","sum_properties","sum_userProperties","sum_conversationId","sum_projectId","sum_integrationId","count_id","count_type","count_messageId","count_createdAt","count_updatedAt","count_organizationId","count_reasons","count_sources","count_details","count_properties","count_userProperties","count_conversationId","count_projectId","count_integrationId","avg_id","avg_type","avg_messageId","avg_createdAt","avg_updatedAt","avg_organizationId","avg_reasons","avg_sources","avg_details","avg_properties","avg_userProperties","avg_conversationId","avg_projectId","avg_integrationId","min_id","min_type","min_messageId","min_createdAt","min_updatedAt","min_organizationId","min_reasons","min_sources","min_details","min_properties","min_userProperties","min_conversationId","min_projectId","min_integrationId","max_id","max_type","max_messageId","max_createdAt","max_updatedAt","max_organizationId","max_reasons","max_sources","max_details","max_properties","max_userProperties","max_conversationId","max_projectId","max_integrationId"]},"direction":{"type":"string","enum":["asc","desc"]}},"required":["field","direction"],"description":"Specifies how to order Feedback query results by field and direction","title":"Feedback OrderBy Schema"},"QueryFeedbackRequestBody":{"type":"object","properties":{"select":{"type":"array","items":{"$ref":"#/components/schemas/FeedbackSelection"}},"groupBy":{"type":"array","items":{"$ref":"#/components/schemas/FeedbackGroupBy"}},"where":{"$ref":"#/components/schemas/FeedbackFilter"},"orderBy":{"type":"array","items":{"$ref":"#/components/schemas/FeedbackOrderBy"}},"notes":{"type":"string","maxLength":80,"description":"Notes are not persisted, but may be useful for your debugging purposes","example":"Count of feedback by type"}},"description":"Query Feedback Params","title":"QueryFeedbackRequestBody"},"QuerySemanticThreadsResponseData":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"messageIds":{},"messagesCount":{},"organizationId":{"type":"string"},"question":{"type":"string"},"questionLength":{},"answer":{"type":"string"},"isOnTopic":{},"isClear":{},"isDocumented":{},"isFeatureSupported":{},"isAnswerConfident":{},"gapSummary":{},"subject":{},"category":{},"languages":{},"firstPartyEntities":{},"thirdPartyEntities":{},"emotion":{},"sentiment":{},"questionType":{},"projectId":{"type":"string"},"integrationId":{"type":"string"},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"firstMessageTime":{"type":"string","format":"date-time"},"lastMessageTime":{"type":"string","format":"date-time"},"lastUpdated":{"type":"string","format":"date-time"},"hasPositiveFeedback":{"type":"boolean"},"hasNegativeFeedback":{"type":"boolean"},"conversationIds":{"type":"array","items":{"type":"string"}},"areAIAnnotationsVerified":{},"isInitialQuestionAnswer":{"type":"boolean"},"sum":{"type":"number"},"count":{"type":"number"},"avg":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"id_hour":{"type":"string"},"id_day":{"type":"string"},"id_week":{"type":"string"},"id_month":{"type":"string"},"messageIds_hour":{"type":"string"},"messageIds_day":{"type":"string"},"messageIds_week":{"type":"string"},"messageIds_month":{"type":"string"},"messagesCount_hour":{"type":"string"},"messagesCount_day":{"type":"string"},"messagesCount_week":{"type":"string"},"messagesCount_month":{"type":"string"},"organizationId_hour":{"type":"string"},"organizationId_day":{"type":"string"},"organizationId_week":{"type":"string"},"organizationId_month":{"type":"string"},"question_hour":{"type":"string"},"question_day":{"type":"string"},"question_week":{"type":"string"},"question_month":{"type":"string"},"questionLength_hour":{"type":"string"},"questionLength_day":{"type":"string"},"questionLength_week":{"type":"string"},"questionLength_month":{"type":"string"},"answer_hour":{"type":"string"},"answer_day":{"type":"string"},"answer_week":{"type":"string"},"answer_month":{"type":"string"},"isOnTopic_hour":{"type":"string"},"isOnTopic_day":{"type":"string"},"isOnTopic_week":{"type":"string"},"isOnTopic_month":{"type":"string"},"isClear_hour":{"type":"string"},"isClear_day":{"type":"string"},"isClear_week":{"type":"string"},"isClear_month":{"type":"string"},"isDocumented_hour":{"type":"string"},"isDocumented_day":{"type":"string"},"isDocumented_week":{"type":"string"},"isDocumented_month":{"type":"string"},"isFeatureSupported_hour":{"type":"string"},"isFeatureSupported_day":{"type":"string"},"isFeatureSupported_week":{"type":"string"},"isFeatureSupported_month":{"type":"string"},"isAnswerConfident_hour":{"type":"string"},"isAnswerConfident_day":{"type":"string"},"isAnswerConfident_week":{"type":"string"},"isAnswerConfident_month":{"type":"string"},"gapSummary_hour":{"type":"string"},"gapSummary_day":{"type":"string"},"gapSummary_week":{"type":"string"},"gapSummary_month":{"type":"string"},"subject_hour":{"type":"string"},"subject_day":{"type":"string"},"subject_week":{"type":"string"},"subject_month":{"type":"string"},"category_hour":{"type":"string"},"category_day":{"type":"string"},"category_week":{"type":"string"},"category_month":{"type":"string"},"languages_hour":{"type":"string"},"languages_day":{"type":"string"},"languages_week":{"type":"string"},"languages_month":{"type":"string"},"firstPartyEntities_hour":{"type":"string"},"firstPartyEntities_day":{"type":"string"},"firstPartyEntities_week":{"type":"string"},"firstPartyEntities_month":{"type":"string"},"thirdPartyEntities_hour":{"type":"string"},"thirdPartyEntities_day":{"type":"string"},"thirdPartyEntities_week":{"type":"string"},"thirdPartyEntities_month":{"type":"string"},"emotion_hour":{"type":"string"},"emotion_day":{"type":"string"},"emotion_week":{"type":"string"},"emotion_month":{"type":"string"},"sentiment_hour":{"type":"string"},"sentiment_day":{"type":"string"},"sentiment_week":{"type":"string"},"sentiment_month":{"type":"string"},"questionType_hour":{"type":"string"},"questionType_day":{"type":"string"},"questionType_week":{"type":"string"},"questionType_month":{"type":"string"},"projectId_hour":{"type":"string"},"projectId_day":{"type":"string"},"projectId_week":{"type":"string"},"projectId_month":{"type":"string"},"integrationId_hour":{"type":"string"},"integrationId_day":{"type":"string"},"integrationId_week":{"type":"string"},"integrationId_month":{"type":"string"},"properties_hour":{"type":"string"},"properties_day":{"type":"string"},"properties_week":{"type":"string"},"properties_month":{"type":"string"},"userProperties_hour":{"type":"string"},"userProperties_day":{"type":"string"},"userProperties_week":{"type":"string"},"userProperties_month":{"type":"string"},"firstMessageTime_hour":{"type":"string"},"firstMessageTime_day":{"type":"string"},"firstMessageTime_week":{"type":"string"},"firstMessageTime_month":{"type":"string"},"lastMessageTime_hour":{"type":"string"},"lastMessageTime_day":{"type":"string"},"lastMessageTime_week":{"type":"string"},"lastMessageTime_month":{"type":"string"},"lastUpdated_hour":{"type":"string"},"lastUpdated_day":{"type":"string"},"lastUpdated_week":{"type":"string"},"lastUpdated_month":{"type":"string"},"hasPositiveFeedback_hour":{"type":"string"},"hasPositiveFeedback_day":{"type":"string"},"hasPositiveFeedback_week":{"type":"string"},"hasPositiveFeedback_month":{"type":"string"},"hasNegativeFeedback_hour":{"type":"string"},"hasNegativeFeedback_day":{"type":"string"},"hasNegativeFeedback_week":{"type":"string"},"hasNegativeFeedback_month":{"type":"string"},"conversationIds_hour":{"type":"string"},"conversationIds_day":{"type":"string"},"conversationIds_week":{"type":"string"},"conversationIds_month":{"type":"string"},"areAIAnnotationsVerified_hour":{"type":"string"},"areAIAnnotationsVerified_day":{"type":"string"},"areAIAnnotationsVerified_week":{"type":"string"},"areAIAnnotationsVerified_month":{"type":"string"},"isInitialQuestionAnswer_hour":{"type":"string"},"isInitialQuestionAnswer_day":{"type":"string"},"isInitialQuestionAnswer_week":{"type":"string"},"isInitialQuestionAnswer_month":{"type":"string"},"sum_id":{"type":"number"},"sum_messageIds":{"type":"number"},"sum_messagesCount":{"type":"number"},"sum_organizationId":{"type":"number"},"sum_question":{"type":"number"},"sum_questionLength":{"type":"number"},"sum_answer":{"type":"number"},"sum_isOnTopic":{"type":"number"},"sum_isClear":{"type":"number"},"sum_isDocumented":{"type":"number"},"sum_isFeatureSupported":{"type":"number"},"sum_isAnswerConfident":{"type":"number"},"sum_gapSummary":{"type":"number"},"sum_subject":{"type":"number"},"sum_category":{"type":"number"},"sum_languages":{"type":"number"},"sum_firstPartyEntities":{"type":"number"},"sum_thirdPartyEntities":{"type":"number"},"sum_emotion":{"type":"number"},"sum_sentiment":{"type":"number"},"sum_questionType":{"type":"number"},"sum_projectId":{"type":"number"},"sum_integrationId":{"type":"number"},"sum_properties":{"type":"number"},"sum_userProperties":{"type":"number"},"sum_firstMessageTime":{"type":"number"},"sum_lastMessageTime":{"type":"number"},"sum_lastUpdated":{"type":"number"},"sum_hasPositiveFeedback":{"type":"number"},"sum_hasNegativeFeedback":{"type":"number"},"sum_conversationIds":{"type":"number"},"sum_areAIAnnotationsVerified":{"type":"number"},"sum_isInitialQuestionAnswer":{"type":"number"},"count_id":{"type":"number"},"count_messageIds":{"type":"number"},"count_messagesCount":{"type":"number"},"count_organizationId":{"type":"number"},"count_question":{"type":"number"},"count_questionLength":{"type":"number"},"count_answer":{"type":"number"},"count_isOnTopic":{"type":"number"},"count_isClear":{"type":"number"},"count_isDocumented":{"type":"number"},"count_isFeatureSupported":{"type":"number"},"count_isAnswerConfident":{"type":"number"},"count_gapSummary":{"type":"number"},"count_subject":{"type":"number"},"count_category":{"type":"number"},"count_languages":{"type":"number"},"count_firstPartyEntities":{"type":"number"},"count_thirdPartyEntities":{"type":"number"},"count_emotion":{"type":"number"},"count_sentiment":{"type":"number"},"count_questionType":{"type":"number"},"count_projectId":{"type":"number"},"count_integrationId":{"type":"number"},"count_properties":{"type":"number"},"count_userProperties":{"type":"number"},"count_firstMessageTime":{"type":"number"},"count_lastMessageTime":{"type":"number"},"count_lastUpdated":{"type":"number"},"count_hasPositiveFeedback":{"type":"number"},"count_hasNegativeFeedback":{"type":"number"},"count_conversationIds":{"type":"number"},"count_areAIAnnotationsVerified":{"type":"number"},"count_isInitialQuestionAnswer":{"type":"number"},"avg_id":{"type":"number"},"avg_messageIds":{"type":"number"},"avg_messagesCount":{"type":"number"},"avg_organizationId":{"type":"number"},"avg_question":{"type":"number"},"avg_questionLength":{"type":"number"},"avg_answer":{"type":"number"},"avg_isOnTopic":{"type":"number"},"avg_isClear":{"type":"number"},"avg_isDocumented":{"type":"number"},"avg_isFeatureSupported":{"type":"number"},"avg_isAnswerConfident":{"type":"number"},"avg_gapSummary":{"type":"number"},"avg_subject":{"type":"number"},"avg_category":{"type":"number"},"avg_languages":{"type":"number"},"avg_firstPartyEntities":{"type":"number"},"avg_thirdPartyEntities":{"type":"number"},"avg_emotion":{"type":"number"},"avg_sentiment":{"type":"number"},"avg_questionType":{"type":"number"},"avg_projectId":{"type":"number"},"avg_integrationId":{"type":"number"},"avg_properties":{"type":"number"},"avg_userProperties":{"type":"number"},"avg_firstMessageTime":{"type":"number"},"avg_lastMessageTime":{"type":"number"},"avg_lastUpdated":{"type":"number"},"avg_hasPositiveFeedback":{"type":"number"},"avg_hasNegativeFeedback":{"type":"number"},"avg_conversationIds":{"type":"number"},"avg_areAIAnnotationsVerified":{"type":"number"},"avg_isInitialQuestionAnswer":{"type":"number"},"min_id":{"type":"number"},"min_messageIds":{"type":"number"},"min_messagesCount":{"type":"number"},"min_organizationId":{"type":"number"},"min_question":{"type":"number"},"min_questionLength":{"type":"number"},"min_answer":{"type":"number"},"min_isOnTopic":{"type":"number"},"min_isClear":{"type":"number"},"min_isDocumented":{"type":"number"},"min_isFeatureSupported":{"type":"number"},"min_isAnswerConfident":{"type":"number"},"min_gapSummary":{"type":"number"},"min_subject":{"type":"number"},"min_category":{"type":"number"},"min_languages":{"type":"number"},"min_firstPartyEntities":{"type":"number"},"min_thirdPartyEntities":{"type":"number"},"min_emotion":{"type":"number"},"min_sentiment":{"type":"number"},"min_questionType":{"type":"number"},"min_projectId":{"type":"number"},"min_integrationId":{"type":"number"},"min_properties":{"type":"number"},"min_userProperties":{"type":"number"},"min_firstMessageTime":{"type":"number"},"min_lastMessageTime":{"type":"number"},"min_lastUpdated":{"type":"number"},"min_hasPositiveFeedback":{"type":"number"},"min_hasNegativeFeedback":{"type":"number"},"min_conversationIds":{"type":"number"},"min_areAIAnnotationsVerified":{"type":"number"},"min_isInitialQuestionAnswer":{"type":"number"},"max_id":{"type":"number"},"max_messageIds":{"type":"number"},"max_messagesCount":{"type":"number"},"max_organizationId":{"type":"number"},"max_question":{"type":"number"},"max_questionLength":{"type":"number"},"max_answer":{"type":"number"},"max_isOnTopic":{"type":"number"},"max_isClear":{"type":"number"},"max_isDocumented":{"type":"number"},"max_isFeatureSupported":{"type":"number"},"max_isAnswerConfident":{"type":"number"},"max_gapSummary":{"type":"number"},"max_subject":{"type":"number"},"max_category":{"type":"number"},"max_languages":{"type":"number"},"max_firstPartyEntities":{"type":"number"},"max_thirdPartyEntities":{"type":"number"},"max_emotion":{"type":"number"},"max_sentiment":{"type":"number"},"max_questionType":{"type":"number"},"max_projectId":{"type":"number"},"max_integrationId":{"type":"number"},"max_properties":{"type":"number"},"max_userProperties":{"type":"number"},"max_firstMessageTime":{"type":"number"},"max_lastMessageTime":{"type":"number"},"max_lastUpdated":{"type":"number"},"max_hasPositiveFeedback":{"type":"number"},"max_hasNegativeFeedback":{"type":"number"},"max_conversationIds":{"type":"number"},"max_areAIAnnotationsVerified":{"type":"number"},"max_isInitialQuestionAnswer":{"type":"number"}},"additionalProperties":true,"title":"SemanticThreadResultItem"}},"total":{"type":"number","description":"Total number of results matching the query"},"pageSize":{"type":"number","description":"Number of results per page"},"count":{"type":"number","description":"Number of results in the current response"}},"required":["result","total","pageSize","count"],"description":"Data object containing QuerySemanticThreads query results and pagination information"},"QuerySemanticThreadsResponseBody":{"type":"object","properties":{"status":{"type":"string","enum":["ok"],"description":"Status of the response"},"data":{"$ref":"#/components/schemas/QuerySemanticThreadsResponseData"}},"required":["status","data"],"description":"Response body for QuerySemanticThreads query endpoint"},"SemanticThreadAggregationSelection":{"type":"object","properties":{"type":{"type":"string","enum":["aggregation"]},"aggregation":{"type":"string","enum":["sum","count","countDistinct","avg","min","max"]},"field":{"type":"string","enum":["id","messageIds","messagesCount","organizationId","question","questionLength","answer","isOnTopic","isClear","isDocumented","isFeatureSupported","isAnswerConfident","gapSummary","subject","category","languages","firstPartyEntities","thirdPartyEntities","emotion","sentiment","questionType","projectId","integrationId","properties","userProperties","firstMessageTime","lastMessageTime","lastUpdated","hasPositiveFeedback","hasNegativeFeedback","conversationIds","areAIAnnotationsVerified","isInitialQuestionAnswer"]},"path":{"type":"array","items":{"type":"string"}}},"required":["type","aggregation"],"title":"SemanticThreadAggregationSelection"},"SemanticThreadTimeBasedGroupBySelection":{"type":"object","properties":{"type":{"type":"string","enum":["time"]},"timeUnit":{"$ref":"#/components/schemas/TimeUnit"},"field":{"type":"string","enum":["id","messageIds","messagesCount","organizationId","question","questionLength","answer","isOnTopic","isClear","isDocumented","isFeatureSupported","isAnswerConfident","gapSummary","subject","category","languages","firstPartyEntities","thirdPartyEntities","emotion","sentiment","questionType","projectId","integrationId","properties","userProperties","firstMessageTime","lastMessageTime","lastUpdated","hasPositiveFeedback","hasNegativeFeedback","conversationIds","areAIAnnotationsVerified","isInitialQuestionAnswer"]}},"required":["type","timeUnit"],"title":"SemanticThreadTimeBasedGroupBySelection"},"SemanticThreadSimpleFieldSelection":{"type":"object","properties":{"type":{"type":"string","enum":["field"]},"field":{"type":"string","enum":["id","messageIds","messagesCount","organizationId","question","questionLength","answer","isOnTopic","isClear","isDocumented","isFeatureSupported","isAnswerConfident","gapSummary","subject","category","languages","firstPartyEntities","thirdPartyEntities","emotion","sentiment","questionType","projectId","integrationId","properties","userProperties","firstMessageTime","lastMessageTime","lastUpdated","hasPositiveFeedback","hasNegativeFeedback","conversationIds","areAIAnnotationsVerified","isInitialQuestionAnswer"]},"path":{"type":"array","items":{"type":"string"},"description":"Path to a nested property within a JSON field. Cannot be used when mode is \"json\"."},"mode":{"type":"string","enum":["unpack","json"],"description":"Export mode for JSON/array fields. \"unpack\" (default): Flattens JSON into separate columns (e.g., properties.key1, properties.key2). \"json\": Exports the entire JSON object as a single stringified column. Applicable to: properties, userProperties, and for feedback exports: reasons, sources."}},"required":["type","field"],"title":"SemanticThreadSimpleFieldSelection"},"SemanticThreadSelection":{"anyOf":[{"$ref":"#/components/schemas/SemanticThreadAggregationSelection"},{"$ref":"#/components/schemas/SemanticThreadTimeBasedGroupBySelection"},{"$ref":"#/components/schemas/SemanticThreadSimpleFieldSelection"}],"description":"Fields to select from semantic threads","oneOf":[{"$ref":"#/components/schemas/SemanticThreadAggregationSelection"},{"$ref":"#/components/schemas/SemanticThreadTimeBasedGroupBySelection"},{"$ref":"#/components/schemas/SemanticThreadSimpleFieldSelection"}],"discriminator":{"propertyName":"type","mapping":{"aggregation":"#/components/schemas/SemanticThreadAggregationSelection","time":"#/components/schemas/SemanticThreadTimeBasedGroupBySelection","field":"#/components/schemas/SemanticThreadSimpleFieldSelection"}},"title":"SemanticThreadSelection"},"SemanticThreadField":{"type":"string","enum":["id","messageIds","messagesCount","organizationId","question","questionLength","answer","isOnTopic","isClear","isDocumented","isFeatureSupported","isAnswerConfident","gapSummary","subject","category","languages","firstPartyEntities","thirdPartyEntities","emotion","sentiment","questionType","projectId","integrationId","properties","userProperties","firstMessageTime","lastMessageTime","lastUpdated","hasPositiveFeedback","hasNegativeFeedback","conversationIds","areAIAnnotationsVerified","isInitialQuestionAnswer"],"description":"Available fields for SemanticThread","title":"SemanticThreadField"},"SemanticThreadGroupBy":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/SemanticThreadField"},"path":{"type":"array","items":{"type":"string"}},"includeInSelect":{"type":"boolean","default":true}},"required":["field"],"description":"Group by options for semantic threads","title":"SemanticThreadGroupBy"},"SemanticThreadFilterConditionValue":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"number"},{"type":"array","items":{"type":"string"}},{"type":"string"},{"type":"object","additionalProperties":{}},{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"null"}]}},{"type":"null"}]}},"required":["path","value"]}],"description":"The value to compare the field against. For JSON fields, can be either a JSON object or a {path, value} pair."},"SemanticThreadFilterCondition":{"type":"object","properties":{"condition":{"type":"object","properties":{"field":{"$ref":"#/components/schemas/SemanticThreadField"},"operator":{"$ref":"#/components/schemas/FilterOperator"},"value":{"$ref":"#/components/schemas/SemanticThreadFilterConditionValue"}},"required":["field","operator","value"]}},"required":["condition"],"title":"SemanticThreadFilter Condition"},"SemanticThreadFilterAND":{"type":"object","properties":{"and":{"type":"array","description":"SemanticThreadFilter AND condition","title":"SemanticThreadFilter AND condition","items":{"oneOf":[{"$ref":"#/components/schemas/SemanticThreadFilter"}]}}},"required":["and"],"description":"SemanticThreadFilter AND operator","title":"SemanticThreadFilter AND operator"},"SemanticThreadFilterOR":{"type":"object","properties":{"or":{"type":"array","description":"SemanticThreadFilter OR condition","items":{"oneOf":[{"$ref":"#/components/schemas/SemanticThreadFilter"}]}}},"required":["or"],"description":"SemanticThreadFilter OR operator","title":"SemanticThreadFilter OR operator"},"SemanticThreadFilter":{"anyOf":[{"$ref":"#/components/schemas/SemanticThreadFilterCondition"},{"$ref":"#/components/schemas/SemanticThreadFilterAND"},{"$ref":"#/components/schemas/SemanticThreadFilterOR"}],"title":"SemanticThreadFilter"},"SemanticThreadOrderBy":{"type":"object","properties":{"field":{"type":"string","enum":["id","messageIds","messagesCount","organizationId","question","questionLength","answer","isOnTopic","isClear","isDocumented","isFeatureSupported","isAnswerConfident","gapSummary","subject","category","languages","firstPartyEntities","thirdPartyEntities","emotion","sentiment","questionType","projectId","integrationId","properties","userProperties","firstMessageTime","lastMessageTime","lastUpdated","hasPositiveFeedback","hasNegativeFeedback","conversationIds","areAIAnnotationsVerified","isInitialQuestionAnswer","id_hour","id_day","id_week","id_month","messageIds_hour","messageIds_day","messageIds_week","messageIds_month","messagesCount_hour","messagesCount_day","messagesCount_week","messagesCount_month","organizationId_hour","organizationId_day","organizationId_week","organizationId_month","question_hour","question_day","question_week","question_month","questionLength_hour","questionLength_day","questionLength_week","questionLength_month","answer_hour","answer_day","answer_week","answer_month","isOnTopic_hour","isOnTopic_day","isOnTopic_week","isOnTopic_month","isClear_hour","isClear_day","isClear_week","isClear_month","isDocumented_hour","isDocumented_day","isDocumented_week","isDocumented_month","isFeatureSupported_hour","isFeatureSupported_day","isFeatureSupported_week","isFeatureSupported_month","isAnswerConfident_hour","isAnswerConfident_day","isAnswerConfident_week","isAnswerConfident_month","gapSummary_hour","gapSummary_day","gapSummary_week","gapSummary_month","subject_hour","subject_day","subject_week","subject_month","category_hour","category_day","category_week","category_month","languages_hour","languages_day","languages_week","languages_month","firstPartyEntities_hour","firstPartyEntities_day","firstPartyEntities_week","firstPartyEntities_month","thirdPartyEntities_hour","thirdPartyEntities_day","thirdPartyEntities_week","thirdPartyEntities_month","emotion_hour","emotion_day","emotion_week","emotion_month","sentiment_hour","sentiment_day","sentiment_week","sentiment_month","questionType_hour","questionType_day","questionType_week","questionType_month","projectId_hour","projectId_day","projectId_week","projectId_month","integrationId_hour","integrationId_day","integrationId_week","integrationId_month","properties_hour","properties_day","properties_week","properties_month","userProperties_hour","userProperties_day","userProperties_week","userProperties_month","firstMessageTime_hour","firstMessageTime_day","firstMessageTime_week","firstMessageTime_month","lastMessageTime_hour","lastMessageTime_day","lastMessageTime_week","lastMessageTime_month","lastUpdated_hour","lastUpdated_day","lastUpdated_week","lastUpdated_month","hasPositiveFeedback_hour","hasPositiveFeedback_day","hasPositiveFeedback_week","hasPositiveFeedback_month","hasNegativeFeedback_hour","hasNegativeFeedback_day","hasNegativeFeedback_week","hasNegativeFeedback_month","conversationIds_hour","conversationIds_day","conversationIds_week","conversationIds_month","areAIAnnotationsVerified_hour","areAIAnnotationsVerified_day","areAIAnnotationsVerified_week","areAIAnnotationsVerified_month","isInitialQuestionAnswer_hour","isInitialQuestionAnswer_day","isInitialQuestionAnswer_week","isInitialQuestionAnswer_month","sum_id","sum_messageIds","sum_messagesCount","sum_organizationId","sum_question","sum_questionLength","sum_answer","sum_isOnTopic","sum_isClear","sum_isDocumented","sum_isFeatureSupported","sum_isAnswerConfident","sum_gapSummary","sum_subject","sum_category","sum_languages","sum_firstPartyEntities","sum_thirdPartyEntities","sum_emotion","sum_sentiment","sum_questionType","sum_projectId","sum_integrationId","sum_properties","sum_userProperties","sum_firstMessageTime","sum_lastMessageTime","sum_lastUpdated","sum_hasPositiveFeedback","sum_hasNegativeFeedback","sum_conversationIds","sum_areAIAnnotationsVerified","sum_isInitialQuestionAnswer","count_id","count_messageIds","count_messagesCount","count_organizationId","count_question","count_questionLength","count_answer","count_isOnTopic","count_isClear","count_isDocumented","count_isFeatureSupported","count_isAnswerConfident","count_gapSummary","count_subject","count_category","count_languages","count_firstPartyEntities","count_thirdPartyEntities","count_emotion","count_sentiment","count_questionType","count_projectId","count_integrationId","count_properties","count_userProperties","count_firstMessageTime","count_lastMessageTime","count_lastUpdated","count_hasPositiveFeedback","count_hasNegativeFeedback","count_conversationIds","count_areAIAnnotationsVerified","count_isInitialQuestionAnswer","avg_id","avg_messageIds","avg_messagesCount","avg_organizationId","avg_question","avg_questionLength","avg_answer","avg_isOnTopic","avg_isClear","avg_isDocumented","avg_isFeatureSupported","avg_isAnswerConfident","avg_gapSummary","avg_subject","avg_category","avg_languages","avg_firstPartyEntities","avg_thirdPartyEntities","avg_emotion","avg_sentiment","avg_questionType","avg_projectId","avg_integrationId","avg_properties","avg_userProperties","avg_firstMessageTime","avg_lastMessageTime","avg_lastUpdated","avg_hasPositiveFeedback","avg_hasNegativeFeedback","avg_conversationIds","avg_areAIAnnotationsVerified","avg_isInitialQuestionAnswer","min_id","min_messageIds","min_messagesCount","min_organizationId","min_question","min_questionLength","min_answer","min_isOnTopic","min_isClear","min_isDocumented","min_isFeatureSupported","min_isAnswerConfident","min_gapSummary","min_subject","min_category","min_languages","min_firstPartyEntities","min_thirdPartyEntities","min_emotion","min_sentiment","min_questionType","min_projectId","min_integrationId","min_properties","min_userProperties","min_firstMessageTime","min_lastMessageTime","min_lastUpdated","min_hasPositiveFeedback","min_hasNegativeFeedback","min_conversationIds","min_areAIAnnotationsVerified","min_isInitialQuestionAnswer","max_id","max_messageIds","max_messagesCount","max_organizationId","max_question","max_questionLength","max_answer","max_isOnTopic","max_isClear","max_isDocumented","max_isFeatureSupported","max_isAnswerConfident","max_gapSummary","max_subject","max_category","max_languages","max_firstPartyEntities","max_thirdPartyEntities","max_emotion","max_sentiment","max_questionType","max_projectId","max_integrationId","max_properties","max_userProperties","max_firstMessageTime","max_lastMessageTime","max_lastUpdated","max_hasPositiveFeedback","max_hasNegativeFeedback","max_conversationIds","max_areAIAnnotationsVerified","max_isInitialQuestionAnswer"]},"direction":{"type":"string","enum":["asc","desc"]}},"required":["field","direction"],"description":"Specifies how to order SemanticThread query results by field and direction","title":"SemanticThread OrderBy Schema"},"QuerySemanticThreadsRequestBody":{"type":"object","properties":{"query":{"type":"string"},"select":{"type":"array","items":{"$ref":"#/components/schemas/SemanticThreadSelection"}},"groupBy":{"type":"array","items":{"$ref":"#/components/schemas/SemanticThreadGroupBy"}},"where":{"$ref":"#/components/schemas/SemanticThreadFilter"},"orderBy":{"type":"array","items":{"$ref":"#/components/schemas/SemanticThreadOrderBy"}},"notes":{"type":"string","maxLength":80,"description":"Notes are not persisted, but may be useful for your debugging purposes","example":"Count of chat sessions with documentation gaps by integration"}},"description":"Query Semantic Threads Params","title":"QuerySemanticThreadsRequestBody"},"PropertyKeysResponseBody":{"type":"object","properties":{"results":{"type":"array","items":{"type":"string","description":"Property key name","example":"theme"}}},"required":["results"],"title":"PropertyKeysResponseBody"},"PropertyKeysRequestBody":{"type":"object","properties":{"field":{"type":"string","enum":["properties","userProperties"]},"views":{"type":"array","items":{"type":"string","enum":["events_view","conversations_view","semantic_threads_view","feedback_view"]},"description":"Optional list of views to query (defaults to all views)","example":["events_view","conversations_view","semantic_threads_view","feedback_view"]},"where":{"anyOf":[{"$ref":"#/components/schemas/EventsFilterCondition"},{"$ref":"#/components/schemas/EventsFilterAND"},{"$ref":"#/components/schemas/EventsFilterOR"},{"$ref":"#/components/schemas/ConversationsFilterCondition"},{"$ref":"#/components/schemas/ConversationsFilterAND"},{"$ref":"#/components/schemas/ConversationsFilterOR"},{"$ref":"#/components/schemas/SemanticThreadFilterCondition"},{"$ref":"#/components/schemas/SemanticThreadFilterAND"},{"$ref":"#/components/schemas/SemanticThreadFilterOR"},{"$ref":"#/components/schemas/FeedbackFilterCondition"},{"$ref":"#/components/schemas/FeedbackFilterAND"},{"$ref":"#/components/schemas/FeedbackFilterOR"}]}},"required":["field"],"description":"Query Property Keys Params","title":"PropertyKeysRequestBody"},"PropertyValuesResponseBody":{"type":"object","properties":{"results":{"type":"array","items":{"type":"string","description":"Property key values","example":"dark"}}},"required":["results"],"title":"PropertyValuesResponseBody"},"PropertyValuesRequestBody":{"type":"object","properties":{"field":{"type":"string","enum":["properties","userProperties"],"description":"Which JSON field to query values from","example":"properties"},"key":{"type":"string","description":"The property key to get values for","example":"theme"},"views":{"type":"array","items":{"type":"string","enum":["events_view","conversations_view","semantic_threads_view","feedback_view"]},"description":"Optional list of views to query (defaults to all views)","example":["events_view","conversations_view","semantic_threads_view","feedback_view"]},"where":{"anyOf":[{"$ref":"#/components/schemas/EventsFilterCondition"},{"$ref":"#/components/schemas/EventsFilterAND"},{"$ref":"#/components/schemas/EventsFilterOR"},{"$ref":"#/components/schemas/ConversationsFilterCondition"},{"$ref":"#/components/schemas/ConversationsFilterAND"},{"$ref":"#/components/schemas/ConversationsFilterOR"},{"$ref":"#/components/schemas/SemanticThreadFilterCondition"},{"$ref":"#/components/schemas/SemanticThreadFilterAND"},{"$ref":"#/components/schemas/SemanticThreadFilterOR"},{"$ref":"#/components/schemas/FeedbackFilterCondition"},{"$ref":"#/components/schemas/FeedbackFilterAND"},{"$ref":"#/components/schemas/FeedbackFilterOR"}]},"limit":{"type":"number","minimum":1,"maximum":1000,"default":100,"description":"Maximum number of values to return","example":100}},"required":["field","key"],"description":"Query Property Values Params","title":"PropertyValuesRequestBody"}},"parameters":{}},"paths":{"/conversations":{"post":{"security":[{"WebIntegrationKey":[]},{"ApiIntegrationKey":[]}],"summary":"Log Conversation","operationId":"logConversation","tags":["conversation"],"description":"Logs a new conversation or updates an existing one with new messages. Always include all messages.\n\n**API Key Types:** `WEB`, `API`","requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConversation"}}}},"responses":{"200":{"description":"Conversation upserted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}},"get":{"security":[{"ApiIntegrationKey":[]}],"summary":"Get All Conversations","operationId":"getAllConversation","tags":["conversation"],"parameters":[{"schema":{"type":["integer","null"],"minimum":0,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"Conversations retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"conversations":{"type":"array","items":{"$ref":"#/components/schemas/Conversation"}},"total":{"type":"number"},"pageSize":{"type":"number"},"count":{"type":"number"}},"required":["conversations","total","pageSize","count"]}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/conversations/{id}":{"get":{"security":[{"WebIntegrationKey":[]},{"ApiIntegrationKey":[]}],"summary":"Get Conversation","operationId":"getConversation","tags":["conversation"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Conversation retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}},"delete":{"security":[{"WebIntegrationKey":[]},{"ApiIntegrationKey":[]}],"summary":"Delete Conversation","operationId":"deleteConversation","tags":["conversation"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Conversation deleted successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/conversations/external/{externalId}":{"get":{"security":[{"ApiIntegrationKey":[]}],"summary":"Get Conversation by External ID","operationId":"getConversationByExternalId","tags":["conversation"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"externalId","in":"path"}],"responses":{"200":{"description":"Conversation retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Conversation"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/feedback":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Log Feedback","operationId":"logFeedback","tags":["feedback"],"description":"Logs new feedback or updates an existing one.\n\n**API Key Types:**  `WEB`, `API`","requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["positive","negative"]},"messageId":{"type":"string"},"createdAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"A timestamp in ISO 8601 format with timezone information. If not provided, the current time will be used."},"reasons":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":"string"},"details":{"type":"string"}},"required":["label","details"]}},"details":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"sources":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":["string","null"],"enum":["positive","negative","new"]},"title":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["type"]}}},"required":["type","messageId"]}}}},"responses":{"200":{"description":"Feedback logged successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["positive","negative"]},"messageId":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"reasons":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":"string"},"details":{"type":"string"}},"required":["label","details"]}},"details":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"sources":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":["string","null"],"enum":["positive","negative","new"]},"title":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["type"]}}},"required":["id","type","messageId","createdAt","updatedAt"]}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}},"get":{"security":[{"ApiIntegrationKey":[]}],"summary":"Get All Feedback","operationId":"getAllFeedback","tags":["feedback"],"parameters":[{"schema":{"type":["integer","null"],"minimum":0,"maximum":100,"default":10},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"default":0},"required":false,"name":"offset","in":"query"}],"responses":{"200":{"description":"All feedback retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAllFeedbackResponse"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/feedback/{id}":{"get":{"security":[{"ApiIntegrationKey":[]}],"summary":"Get Feedback by ID","operationId":"getFeedbackById","tags":["feedback"],"parameters":[{"schema":{"type":"string","example":"feedback-id-123"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Feedback retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["positive","negative"]},"messageId":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"reasons":{"type":["array","null"],"items":{"type":"object","properties":{"label":{"type":"string"},"details":{"type":"string"}},"required":["label","details"]}},"details":{"type":["string","null"]},"properties":{"type":["object","null"],"properties":{},"description":"A customizable collection of custom properties or attributes.","additionalProperties":true},"userProperties":{"type":["object","null"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the inkeep widget."},"identificationType":{"type":["string","null"],"description":"The type of identification for the user. This value is sent by the inkeep widget.","example":"COOKIED"},"userId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"null"}],"description":"The unique identifier for the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentName":{"type":["string","null"],"description":"The name of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"supportAgentEmail":{"type":["string","null"],"description":"The email of the support agent assigned to the user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."},"userType":{"type":["string","null"],"description":"The type of user. This value is sent by the Inkeep Support Agent Copilot. This value is used to create the graphs on the Inkeep Portal."}},"description":"A customizable collection of custom properties or attributes. Some properties have first class support for the Inkeep Portal or Widget and are noted in the description.","additionalProperties":true},"sources":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":["string","null"],"enum":["positive","negative","new"]},"title":{"type":["string","null"]},"url":{"type":["string","null"]}},"required":["type"]}},"conversation":{"$ref":"#/components/schemas/Conversation"},"message":{"$ref":"#/components/schemas/Message"}},"required":["id","type","messageId","createdAt","updatedAt","conversation","message"]}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}},"delete":{"security":[{"ApiIntegrationKey":[]}],"summary":"Delete Feedback by ID","operationId":"deleteFeedbackById","tags":["feedback"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Feedback deleted successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"message":{"type":"string"}},"required":["success","message"]}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"404":{"description":"Not Found","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/events":{"post":{"security":[{"WebIntegrationKey":[]},{"ApiIntegrationKey":[]}],"summary":"Log Event","operationId":"logEvent","tags":["event"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsertEvent"}}}},"responses":{"200":{"description":"Event logged successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectEvent"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/top-search-queries":{"get":{"security":[{"ApiIntegrationKey":[]}],"summary":"Top Search Queries","operationId":"topSearchQueries","parameters":[{"schema":{"type":"string"},"required":false,"name":"after","in":"query"},{"schema":{"type":"string"},"required":false,"name":"project_id","in":"query"}],"responses":{"200":{"description":"Top search queries","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"search_query":{"type":"string"},"count":{"type":"string"}},"required":["search_query","count"]}},"total":{"type":"number"}},"required":["result","total"]}},"required":["data"]}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/weekly-search-users":{"get":{"security":[{"ApiIntegrationKey":[]}],"summary":"Weekly Search Users","operationId":"weeklySearchUsers","parameters":[{"schema":{"type":"string"},"required":false,"name":"after","in":"query"},{"schema":{"type":"string"},"required":false,"name":"project_id","in":"query"}],"responses":{"200":{"description":"Weekly search users","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"week":{"type":"string"},"unique_users":{"type":"string"}},"required":["week","unique_users"]}},"total":{"type":"number"}},"required":["result","total"]}},"required":["data"]}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/conversations":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Query Conversations","operationId":"queryConversations","tags":["Query"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryConversationsRequestBody"}}}},"responses":{"200":{"description":"Query Conversations Results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryConversationsResponseBody"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/events":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Query Events","operationId":"queryEvents","tags":["Query"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryEventsRequestBody"}}}},"responses":{"200":{"description":"Query results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryEventsResponseBody"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/feedback":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Query Feedback","operationId":"queryFeedback","tags":["Query"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryFeedbackRequestBody"}}}},"responses":{"200":{"description":"Query Feedback Results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryFeedbackResponseBody"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/semantic-threads":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Query Semantic Threads","operationId":"querySemanticThreads","tags":["Query"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuerySemanticThreadsRequestBody"}}}},"responses":{"200":{"description":"Query Semantic Threads result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuerySemanticThreadsResponseBody"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/semantic-threads/export":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Export Semantic Threads Query Results","operationId":"exportSemanticThreadsQueryResults","tags":["Query"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuerySemanticThreadsRequestBody"}}}},"responses":{"200":{"description":"CSV file containing query results","content":{"text/csv":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/conversations/export":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Export Conversations Query Results","operationId":"exportConversationsQueryResults","tags":["Query"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryConversationsRequestBody"}}}},"responses":{"200":{"description":"CSV file containing query results","content":{"text/csv":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/events/export":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Export Events Query Results","operationId":"exportEventsQueryResults","tags":["Query"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryEventsRequestBody"}}}},"responses":{"200":{"description":"CSV file containing query results","content":{"text/csv":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/feedback/export":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Export Feedback Query Results","operationId":"exportFeedbackQueryResults","tags":["Query"],"requestBody":{"description":"Note: The maximum size of the request body is 2 MB.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryFeedbackRequestBody"}}}},"responses":{"200":{"description":"CSV file containing query results","content":{"text/csv":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/property-keys":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Query Property Keys","operationId":"queryPropertyKeys","tags":["Query"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyKeysRequestBody"}}}},"responses":{"200":{"description":"Property keys query results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyKeysResponseBody"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}},"/query/property-values":{"post":{"security":[{"ApiIntegrationKey":[]}],"summary":"Query Property Values","operationId":"queryPropertyValues","tags":["Query"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyValuesRequestBody"}}}},"responses":{"200":{"description":"Property values query results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropertyValuesResponseBody"}}}},"400":{"description":"Bad Request","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Forbidden","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"422":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnprocessableEntity"}}}},"500":{"description":"Internal Server Error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}}}}}}},"webhooks":{}}